https://yun7211.github.io/tags/%E9%83%A8%E7%BD%B2/Recent content in 部署 on Yun 的个人博客Hugo -- gohugo.iozh-cnMon, 18 May 2026 09:20:00 +0800https://yun7211.github.io/posts/github-pages-deploy-checklist/Mon, 18 May 2026 09:20:00 +0800https://yun7211.github.io/posts/github-pages-deploy-checklist/<h2 id="配置检查">配置检查 </h2><p>部署前先确认 <code>hugo.toml</code> 中的站点地址、语言、标题和分页配置。<code>baseURL</code> 会影响线上资源路径，尤其是样式和图片。</p> <p>如果使用 GitHub Pages 的用户站点，常见地址是：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"><span class="line"><span class="cl"><span class="nx">baseURL</span> <span class="p">=</span> <span class="s2">&#34;https://username.github.io/&#34;</span> </span></span></code></pre></div><p>如果使用项目站点，则通常需要带上仓库名。</p> <h2 id="内容检查">内容检查 </h2><p>发布前至少检查这些内容：</p> <ul> <li>首页能说明博客主题</li> <li>About 页面不是空白</li> <li>至少有几篇正式文章</li> <li>文章 <code>draft = false</code></li> <li>日期不是未来时间</li> <li>图片路径大小写一致</li> <li>没有提交私钥、邮箱明文或私人照片</li> </ul> <h2 id="actions-检查">Actions 检查 </h2><p>GitHub 仓库的 Pages Source 需要选择 GitHub Actions。工作流构建时要安装 Hugo Extended，并上传 <code>public</code> 目录作为 Pages artifact。</p> <p>常用构建命令是：</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo --gc --minify </span></span></code></pre></div><h2 id="小结">小结 </h2><p>部署问题通常不是 Hugo 本身复杂，而是路径、草稿状态、Actions 权限和 Pages 设置容易漏。上线前做一次清单检查，可以省掉很多排查时间。</p>