根本原因是hugo默认不处理assets目录的sass/ts等源文件，也不自动注入css路径；它只原样复制static/内容，而模板中引用的assets/css/main.css实际不存在，导致404和无样式。
为什么 hugo build 生成的页面没有 CSS 样式
根本原因通常是 hugo 默认不处理 assets 目录下的原始 Sass/SCSS、TypeScript 或未编译的 JS，也不自动注入 CSS 路径——它只把 static/ 下的文件原样复制过去，而主题或自定义模板里写的 rel="stylesheet" 链接如果指向了 assets/css/main.css 这类路径，实际并不存在。
常见错误现象：404 控制台报错找不到 /css/main.css；页面文字堆叠无排版；hugo server 本地预览正常但 hugo build 后线上失效。
- 确认你用的是支持 Asset Pipeline 的主题（比如
hugo-theme-keep），或者自己写了resources.ExecuteAsTemplate流程 - 检查
layouts/partials/head.html中是否用了{{ $css := resources.Get "scss/main.scss" | resources.ToCSS }}这类调用，而不是直接写<link href="/css/main.css"> - 确保
hugo version≥ 0.110，旧版本对resources的支持不完整，尤其在 Windows 上容易静默失败
如何让 Markdown 中的代码块自动带语言标签和复制按钮
Hugo 本身不提供复制按钮，但可通过组合 highlight + chroma + 少量 JS 实现。关键不是“加功能”，而是避免把 highlight 配置写错导致语言名丢失。
使用场景：技术博客写 Go 示例时想显示 func main() 并允许读者一键复制；不想手动给每个代码块加 language-go 类名。
立即学习“go语言免费学习笔记（深入）”；
08cms企业建站系统是基于08cmsv3.4核心程序，通过系统架构，模板制作，并根据此系统的功能和操作流程进行了代码优化。由08cms官方团队开发。安装链接：install.php、管理后台链接：admina.php日常管理请不要使用创始人帐号（admin），系统内置有内容管理帐号08cms：密码08cms系统特点：1、系统可自动生成静态页面；2、根据企业系统的特点，基于08cms V3.4核心
- 在
config.yaml中启用 Chroma：设置pygmentsCodeFences: true和pygmentsUseClasses: true - Markdown 写法必须是
```go开头，不能写成```golang或```GO—— Chroma 只认标准别名，否则 fallback 成纯文本 - 复制按钮需自行引入轻量 JS，比如
clipboard.js，绑定到pre code元素；注意不要重复初始化，否则多个按钮点击都复制第一个块
content/ 下的 _index.md 不生效？
Hugo 把 _index.md 当作“列表页内容”，但它只在目录有子页面或显式设置了 type 时才渲染。空目录下放 _index.md，默认被忽略。
常见错误现象：访问 /posts/ 显示 404；hugo server 日志提示 Skipping empty section "posts"；模板中 .Pages 为空但你确信写了 _index.md。
- 确保该目录下至少有一个非
_index.md的 Markdown 文件（哪怕只是placeholder.md），否则 Hugo 认为“这不是一个合法 section” - 在
_index.md前置参数中显式写type: "posts"，并确认layouts/_default/list.html存在且能匹配这个 type - 如果只想做单页介绍（如文档首页），改用
content/_index.md（根目录）或启用cascade在config.yaml中全局指定type
部署到 GitHub Pages 后图片路径全 404
根本问题出在 baseURL：本地用 hugo server 时默认 baseURL = "http://localhost:1313/"，但 GitHub Pages 是 https://<user>.github.io/<repo>/</repo></user>，相对路径会错位。
性能影响不大，但兼容性极差——所有  会被解析成 /img/foo.png，而实际路径是 /<repo>/img/foo.png</repo>。
- 构建前必须设
hugo --baseURL "https://username.github.io/repo/"，不能依赖 config 中的默认值 - 更稳妥的做法是用
absURL函数：把改成![]({{ "img/foo.png" | absURL }}) - 如果用了
static/img/，确保config.yaml中没误配publishDir: "docs"却忘了同步static/到该目录
最常被忽略的是：GitHub Pages 的项目站点（username.github.io/repo）和用户站点（username.github.io）对 baseURL 的要求完全不同，写死一个值撑不过两种部署场景。
