本文的读者需要先设置一个本地运行的博客。如果没有搭建,可以查看我的文章:搭建网站指南

请注意,文中提到的所有 <username> 需要替换为你的 GitHub 用户名,不带尖括号。

在 GitHub 上设置仓库 链接到标题

首先,你需要创建一个名为 <username>.github.io 的仓库,并设置为公开仓库。(部分在线教程建议设置为私有仓库来存储 md 文件,但作者发现,Hugo 生成的公开文件本身就是 html 文件,不包含 md 文件上传,因此无需担心源代码泄露问题)

检查 baseURL 配置 链接到标题

需要修改 hugo.toml 文件的第一行:

baseURL = "https://<username>.github.io/"

然后在命令行中运行以下命令: 链接到标题

# 删除 public 文件夹并重新生成网站
#(如果没有 public 文件夹,则无需删除)
rm -rf public/
hugo
# 将更新推送到 GitHub

git remote add origin https://github.com/<username>/<username>.github.io.git
git add .
# 这相当于提交到 GitHub,可以自行修改提交信息
git commit -m "deploy"
# 如果你的推送分支不是 master,需要重命名为 main
git push --force origin master:main

如果在运行 git remote add... 时出现错误:error: remote origin already exists.,意味着你之前已经添加过远程仓库。

你可以运行 git remote -v 来验证这个情况。

删除并重新添加远程仓库 链接到标题

删除命令:

git remote rm origin

然后重新运行 git remote add...,接着执行 git add .git commitgit push,耐心等待上传成功。然后在 GitHub 仓库中进行如下设置:

设置 GitHub Pages 链接到标题

在 GitHub 仓库中,进入 Settings -> (Code and automation) -> Pages,在 Build and deployment 选项下选择 deploy from a branch,并选择你的 main 分支。

稍等片刻,几分钟后你就可以在 GitHub Pages 上看到你的网站。