快速上手：Hugo 个人博客创建流程与避坑指南

Hugo 是目前最流行的静态网站生成器之一。本笔记记录了从环境配置到站点发布的完整流程，并针对初学者容易遇到的“404错误”和“路径失效”问题进行了重点标注。

1. 安装与环境配置

搭建博客的第一步是让你的系统识别 Hugo 指令。

• 安装程序：下载 Hugo 压缩包（建议选择 hugo_extended 版本以支持高级主题）。
• 初始化站点：在存放 hugo.exe 的文件夹下打开终端，执行： hugo new site my_blog
• 环境变量：将 hugo.exe 路径加入系统变量 Path。

  注意：配置后必须重启 CMD 或 PowerShell 窗口，设置才会生效。

2. 核心原理：主题安装与层级规范

Hugo 的页面渲染依赖于主题。如果主题存放位置不对，会导致服务启动后页面显示空白。

⚠️ 避坑重点：文件夹嵌套问题

下载主题压缩包后，存放到 my_blog\themes\ 中。必须确保结构符合以下规范：

解决方法：若出现双层嵌套，需将内层文件全部剪切至第一层 themes\stack 目录下，并删除多余的空文件夹。

3. 内容创作流程

创建文章并不是手动新建 .md 文件，而是建议使用 Hugo 内置指令来生成带元数据的模板。

1. 快速创建： 在 my_blog 路径下输入：hugo new post/Article01.md
   • 注意：路径名 post 需根据主题要求确定。若改为 posts，部分主题可能无法读取。
2. 状态激活： 找到文章文件，将头部信息中的 draft = true 修改为 false。

   关键点：只要 draft 为 true，这篇文章就处于草稿状态，正式预览时将不可见。

4. 预览与发布

在站点根目录下使用终端指令启动本地服务：

• 预览模式：hugo server --buildDrafts (或 hugo server -D)
• 静态构建：直接输入 hugo。

执行 hugo 命令后，系统会生成一个 public 文件夹，这里面就是你博客的所有静态 HTML 页面，你可以将其部署到 GitHub Pages 或云服务器。

5. 结语

创建 Hugo 博客的过程其实是一次微型的“软件部署”实践。重点不在于写代码，而在于理解 目录结构 和 配置文件 的映射关系。只要搞定了主题层级和草稿开关，剩下的就是纯粹的创作了。