最近决定用Hugo重新搭建个人博客，记录一下整个过程，也算是给自己做个备忘录。

这篇先说说环境准备，主要是Git和Hugo的安装。之前折腾过几次，这次想把步骤记录得详细一些。

需要准备的工具

  • Git：用来下载主题和管理代码
  • Hugo：静态网站生成器，博客的核心
  • 文本编辑器：我用的VS Code，其他的也行
  • 浏览器：预览用

安装Git

Git主要用来下载主题和管理代码，后面部署到GitHub也需要用到。

下载Git

去Git官网 https://git-scm.com/ 下载Windows版本。官网首页右侧有个蓝色的"Download"按钮，会自动检测系统，点击就能下载最新版本。

下载完成后会得到一个exe安装包，文件名类似 Git-2.43.0-64-bit.exe。

安装Git

双击exe文件开始安装。安装过程中有几个选项需要注意：

  • 安装路径保持默认就行
  • 组件选择也用默认的
  • 编辑器我选的VS Code，你可以选自己习惯的
  • 重要的是在"Adjusting your PATH environment"页面要选择第二个选项"Git from the command line and also from 3rd-party software"，这样才能在命令行里用Git

其他选项基本都用默认设置，一路Next就行。

验证Git安装

  1. 打开命令提示符：按 Win + R，输入 cmd，回车

  2. 检查版本：输入以下命令

    git --version

  3. 看到版本信息：如 git version 2.43.0.windows.1 表示安装成功

    💡 命令行说明：在黑色的命令提示符窗口中，输入命令后按回车，会显示类似"git version 2.43.0.windows.1"的版本信息，说明Git安装成功。

配置Git用户信息

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"

🚀 第二步：下载Hugo

选择下载方式

我们采用手动下载的方式，这样更直观，适合初学者。

下载Hugo

  1. 访问Hugo发布页：https://github.com/gohugoio/hugo/releases

  2. 选择最新版本：找到最新的Release版本

  3. 下载Windows版本：选择 hugo_extended_x.xx.x_windows-amd64.zip

    ⚠️ 注意：一定要下载 extended 版本，支持更多功能

    💡 页面说明：GitHub Releases页面会列出所有版本的下载文件。找到最新版本，在"Assets"部分选择包含"extended"和"windows-amd64"的zip文件。

  4. 下载完成：得到类似 hugo_extended_0.120.4_windows-amd64.zip 的压缩包

安装Hugo

  1. 创建Hugo目录：

    • 在D盘创建文件夹：D:\Hugo
    • 在Hugo文件夹内创建：D:\Hugo\bin

  2. 解压Hugo：

    • 解压下载的zip文件
    • 将 hugo.exe 文件复制到 D:\Hugo\bin 目录

    💡 文件说明：解压后会得到一个hugo.exe文件（约100MB），将它放到D:\Hugo\bin目录中。这个目录现在应该只包含这一个文件。

配置环境变量

  1. 打开系统属性：

    • 右键"此电脑" → “属性”
    • 点击"高级系统设置"
    • 点击"环境变量"

  2. 编辑Path变量：

    • 在"系统变量"中找到"Path"
    • 点击"编辑"
    • 点击"新建"
    • 添加路径：D:\Hugo\bin
    • 点击"确定"保存

    💡 设置说明：在环境变量编辑窗口中，Path变量会显示为一个列表，每行一个路径。点击"新建"后在新行中输入"D:\Hugo\bin"，然后保存所有对话框。

验证Hugo安装

  1. 重新打开命令提示符：关闭之前的cmd窗口，重新打开

  2. 检查版本：输入以下命令

    hugo version

  3. 看到版本信息：如 hugo v0.120.4+extended windows/amd64 表示安装成功

    💡 版本确认：命令行会显示Hugo的详细版本信息，重要的是要看到"+extended"字样，这表示安装的是扩展版本。

📁 第三步：创建项目目录

创建工作目录

  1. 在D盘创建主目录：

    D:\myblog\

  2. 目录结构规划：

    D:\myblog\
├── myblog\          # Hugo站点目录（稍后创建）
└── themes\          # 主题存放目录（稍后创建）

    💡 目录说明：在文件资源管理器中，D:\myblog目录现在是空的，我们将在后续步骤中创建myblog子目录来存放网站文件。

✅ 环境检查清单

在进入下一步之前，请确认以下项目都已完成：

  • Git已安装并配置用户信息
  • Hugo Extended版本已安装并配置环境变量
  • 命令行可以正常执行 git --version 和 hugo version
  • 已创建 D:\myblog 工作目录

小结

到这里，Git和Hugo都安装好了，工作目录也创建了。下一篇会记录如何创建Hugo站点和安装主题的过程。

有几个问题可能会遇到：

为什么选择手动下载而不是包管理器？ 主要是手动下载比较直观，能清楚地知道每一步在做什么。

必须安装在D盘吗？ 不是的，你可以选择任意位置，保持路径一致就行。

Extended版本和普通版本有什么区别？ Extended版本支持Sass/SCSS处理，有些主题需要这个功能，所以建议用Extended版本。

下一篇：Hugo博客搭建教程（二）：创建站点与主题安装