如何在GitHub上正确管理Hugo项目？现有github.io站点迁移疑问

其实你完全没必要分开维护两个独立仓库！Hugo和Jekyll的工作流确实有差异，但GitHub提供了更高效的方案来统一管理你的Hugo源文件和生成的站点内容，下面给你几种社区常用的实用方案：

1. 单仓库双分支方案（最推荐） #

这是目前最流行的方式，用一个仓库同时托管Hugo源文件和生成的站点：

• 核心逻辑：用主分支（比如main）存放Hugo的所有源文件——包括主题文件、配置文件、markdown文章、静态资源这些；再创建一个gh-pages分支，专门用来存放Hugo生成的public目录内容。
• 操作流程：
  • 先把你的Hugo项目代码推送到仓库的主分支
  • 配置GitHub Actions自动构建：在仓库里添加一个工作流文件（比如.github/workflows/hugo.yml），设置每次推送源文件到主分支时，自动运行hugo命令生成站点，然后把public目录的内容推送到gh-pages分支
  • 最后去GitHub仓库的「Settings」→「Pages」页面，把站点源设置为gh-pages分支的根目录
• 优势：全程自动化，不用手动复制粘贴public内容，只需要维护一个仓库，源文件和生成内容分离清晰，管理起来特别省心

2. 子模块关联双仓库方案（适合习惯分开仓库的场景） #

如果你确实想把源文件和生成站点放在两个仓库，也可以用Git子模块来简化操作：

• 核心逻辑：把你的Hugo源文件放在一个独立仓库（比如[username]/hugo-site），然后把[username]/github.io仓库作为子模块关联到Hugo项目的public目录
• 操作流程：
  • 在Hugo项目根目录执行命令：git submodule add git@github.com:[username]/[username].github.io.git public
  • 每次本地写完内容后，运行hugo生成站点，然后进入public目录，直接提交并推送到github.io仓库即可
• 优势：虽然是两个仓库，但可以在Hugo项目目录里一站式完成内容编写、生成和部署操作，不用来回切换仓库

3. 单仓库直接部署方案（适合极简场景） #

你也可以直接在[username]/github.io仓库里存放Hugo源文件，然后用GitHub Actions自动构建并部署：

• 核心逻辑：把Hugo源文件放在仓库根目录，配置Actions构建后，直接把生成的public内容推送到同一个仓库的gh-pages分支（不推荐覆盖主分支，会导致源文件和生成内容混在一起）
• 注意：这种方式虽然只用一个仓库，但源文件和生成内容会在同一个仓库的不同分支，不如双分支方案清晰，适合站点结构特别简单的情况

对比Jekyll的服务器端构建，Hugo确实需要先构建再部署，但通过上面这些方案，你完全不用手动维护两个独立仓库，双分支方案是社区最推荐的，自动化程度高，也最容易长期维护。

内容的提问来源于stack exchange，提问作者Jiho Choi