https://blog.cxx.pub/tags/%E9%83%A8%E7%BD%B2/Recent content in 部署 on IMXBlogHugozh-cnSat, 13 Jun 2026 00:00:00 +0000https://blog.cxx.pub/posts/github-pages-deployment-guide/Sat, 13 Jun 2026 00:00:00 +0000https://blog.cxx.pub/posts/github-pages-deployment-guide/<h2 id="前言">前言</h2> <p>本文详细介绍如何将 Hugo 静态博客部署到 GitHub Pages，使用 GitHub Actions 实现自动化部署，以及后续如何更新文章。无需手动构建，每次提交代码后自动部署。</p> <h2 id="一准备工作">一、准备工作</h2> <h3 id="11-本地环境">1.1 本地环境</h3> <p>确保已安装：</p> <ul> <li>Git</li> <li>Hugo Extended 版本</li> <li>GitHub 账号</li> </ul> <h3 id="12-hugo-项目结构">1.2 Hugo 项目结构</h3> <pre tabindex="0"><code>my-blog/ ├── .github/ │ └── workflows/ │ └── hugo.yml # GitHub Actions 配置 ├── archetypes/ ├── content/ │ └── posts/ # 文章目录 ├── themes/ │ └── imx-theme/ # 主题 ├── static/ ├── hugo.toml # Hugo 配置文件 └── .gitignore </code></pre><h2 id="二创建-github-仓库">二、创建 GitHub 仓库</h2> <h3 id="21-仓库命名规则">2.1 仓库命名规则</h3> <p>有两种选择：</p> <p><strong>选项 A：用户/组织主页（推荐）</strong></p> <ul> <li>仓库名：<code>username.github.io</code></li> <li>访问地址：<code>https://username.github.io/</code></li> <li>示例：<code>c-x-x.github.io</code> → <code>https://c-x-x.github.io/</code></li> </ul> <p><strong>选项 B：项目页面</strong></p>