从零开始！超详细 Hugo 博客在 GitHub 部署全攻略，新手也能轻松上手

Mz Xi2024-11-162024-12-30

安装 Hugo

首先需要在本地安装 Hugo。Hugo 的安装方式因操作系统而异，以下是常见操作系统的安装方法：
- Windows：可以从 Hugo 的官方 GitHub releases 页面下载适合 Windows 的压缩包，解压后将 hugo.exe 所在的目录添加到系统的环境变量 PATH 中。
- macOS：使用 Homebrew 包管理工具，在终端中输入 brew install hugo进行安装。
- Linux：大多数 Linux 发行版可以使用包管理工具进行安装，例如在 Ubuntu 上可以使用 sudo apt-get install hugo命令安装。

创建 Hugo 站点

打开终端，使用 hugo new site命令创建一个新的 Hugo 站点。例如，要创建一个名为 myblog的站点，可以输入以下命令：

1	hugo new site myblog

这将在当前目录下创建一个名为 myblog的新目录，其中包含了 Hugo 站点的基本结构和配置文件。

选择并安装主题

进入新创建的站点目录 cd myblog，然后初始化 Git 仓库 git init。
从 Hugo 官方主题网站或者 GitHub 上选择一个你喜欢的主题。例如，如果你选择了 ananke主题，可以在站点目录下的终端中输入以下命令来下载并安装该主题：

1	git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke

将主题添加到站点配置文件 config.toml中，找到 theme配置项，将其设置为你所安装的主题名称，例如：

1	theme = "ananke"

创建博客内容

使用 hugo new命令创建新的博客文章。例如，要创建一篇名为 my-first-post.md的文章，可以输入以下命令：

1	hugo new posts/my-first-post.md

这将在 content/posts目录下创建一个新的 Markdown 文件，你可以使用文本编辑器打开该文件，在文件头部的元数据中设置文章的标题、日期、标签等信息，然后在文件主体中撰写文章内容。

本地测试

在本地启动 Hugo 服务器，以便在本地浏览器中预览博客。在站点目录下的终端中输入以下命令：

1	hugo server

其中 -D参数表示包括草稿文章。启动服务器后，在浏览器中访问 http://localhost:1313，即可查看本地的博客站点。

构建静态文件

在将博客部署到 GitHub 之前，需要先使用 Hugo 构建静态文件。在站点目录下的终端中输入以下命令：

1	hugo -D 或者 hugo --minify

这将根据你的文章内容和主题配置生成一个 public目录，其中包含了所有生成的静态 HTML、CSS、JavaScript 等文件，这些文件将被部署到 GitHub 上。

使用Git部署推送

安装 Git：从 Git 官方网站下载并安装适合你操作系统的 Git 版本。安装完成后，在命令行中输入 git --version 来确认安装是否正确。
进入到新创建的项目目录 cd <your_site_name> ，然后使用 Git 进行初始化 git init ，这将在项目目录下创建一个隐藏的 .git 文件夹，用于跟踪项目的版本信息。
配置环境变量：即使安装了 Hugo，若未将 Hugo 的可执行文件路径添加到系统的环境变量中，系统在执行命令时也无法找到该命令。对于不同操作系统，配置环境变量的方法有所不同：
- Windows 系统：右键点击 “此电脑”，选择 “属性”，在弹出的窗口中点击 “高级系统设置”，然后在 “系统属性” 窗口的 “高级” 选项卡下点击 “环境变量” 按钮。在 “系统变量” 列表中找到 “Path” 变量，点击 “编辑”，在弹出的编辑环境变量窗口中点击 “新建”，将 Hugo 可执行文件所在的文件夹路径添加进去，例如 C:\Program Files\Hugo\bin ，然后依次点击 “确定” 保存设置。
- macOS 系统：一般情况下，通过安装包安装 Hugo 后，会自动将其路径添加到环境变量中。若未自动添加，可以打开终端，输入 export PATH=$PATH:/usr/local/bin ，其中 /usr/local/bin 是 Hugo 可执行文件所在的常见路径，若你的安装路径不同，请替换为实际路径。为了使该配置在每次打开终端时都生效，可以将此命令添加到 ~/.bash_profile 或 ~/.zshrc 文件中。
- Linux 系统：编辑 ~/.bashrc 文件，在文件末尾添加 export PATH=$PATH:/usr/local/bin ，同样，如果 Hugo 安装在其他路径，请将 /usr/local/bin 替换为实际路径。保存文件后，在终端执行 source ~/.bashrc 使配置生效。