首次使用 Hugo 时，.md 文件内容未显示在页面上，通常并非路径或模板配置错误，而是 Hugo 构建缓存导致的“假性失效”——清除缓存后即可恢复正常渲染。

首次使用 hugo 时，`.md` 文件内容未显示在页面上，通常并非路径或模板配置错误，而是 hugo 构建缓存导致的“假性失效”——清除缓存后即可恢复正常渲染。

Hugo 在开发过程中会缓存页面解析结果（尤其是涉及多语言、嵌套页面引用或频繁重建的场景），以提升构建速度。但当文件结构刚初始化、内容首次添加，或路径/前言（front matter）发生细微变更时，缓存可能未及时更新，导致 .Content 渲染为空——即使 company.md 路径正确、{{ .Content }} 语法无误、GetPage 调用合法，内容仍不会出现在 HTML 输出中。

✅ 解决方法：强制清除 Hugo 缓存
运行以下命令重启服务：

<code class="bash">hugo server --cleanDestinationDir --ignoreCache -D</code>

• --cleanDestinationDir：清空 public/ 目录，避免旧文件残留；
• --ignoreCache：跳过所有内部缓存（包括页面树、资源指纹、i18n 翻译映射等）；
• -D（--buildDrafts）：确保草稿页也参与构建（便于调试）。

? 补充建议：

• 检查 company.md 是否包含有效 front matter（至少含 --- 分隔符），空文件或格式错误的 YAML/ TOML 会导致 Hugo 忽略该页面；
• 验证 german/home/company 路径是否与实际文件系统一致（Hugo 区分大小写，且不支持 company/index.md 以外的“目录式”单页写法，除非启用 headless: true）；
• 若使用多语言，确认 languageCode 和 defaultContentLanguage 配置与目录名（如 german）匹配，并在 config.toml 中正确定义 languages。

⚠️ 注意：hugo server 默认启用缓存加速，而 hugo（静态构建）缓存行为略有不同。调试阶段建议始终添加 --ignoreCache，待逻辑稳定后再移除以提升性能。

清除缓存是 Hugo 新手最常忽略却最高效的排障步骤——它不修复代码，但能让正确的代码真正生效。