Hugo 静态博客从零部署:5 分钟搭建自己的个人网站
内容提要
本文介绍用Hugo搭建个人博客的完整流程：安装Hugo、创建站点、选择主题（如PaperMod）、撰写Markdown文章、本地预览，并通过GitHub Pages、Vercel或自建服务器部署，同时涵盖Giscus评论、SEO、性能优化与备份迁移。Hugo构建速度快，适合专注写作。
延伸解读
Hugo 的构建速度优势
文章指出，Hugo 使用 Go 语言编写，构建速度极快，千页站点可在秒级完成。相比之下，Hexo 在文章数量增多后构建可能需要几分钟。对于内容量较大的博客，Hugo 能显著减少等待时间，让写作和部署流程更顺畅。
部署方案的选择
文章提供了三种部署方式：GitHub Pages 免费且推荐，Vercel 对国内访问更友好，自建服务器则适合有特定需求的用户。选择时需权衡访问速度、成本和维护难度。GitHub Pages 配合 GitHub Actions 可实现自动部署，简化流程。
SEO 与性能优化要点
Hugo 自动生成 sitemap.xml 和 RSS，便于提交搜索引擎。文章还建议添加 robots.txt、JSON-LD 结构化数据，并通过启用图片懒加载、资源压缩、CDN 加速和 PWA 来提升性能。这些措施有助于提高站点可见性和加载速度。
常见问题与迁移备份
文章提醒注意草稿状态、未来日期和主题缓存可能导致文章不显示或样式错乱。中文 URL 可通过配置永久链接解决。备份时排除 public 和 resources 目录，从 Hexo 迁移可使用 hexo-hugo-migrate 工具转换文章格式。
Q&A
Hugo 和 Hexo 相比有什么优势？
Hugo 的最大优势是构建速度极快，文章多了之后 Hexo 构建可能要几分钟，而 Hugo 几秒就能完成。Hugo 使用 Go 语言，主题数量有 300+，学习曲线中等。
如何安装 Hugo？
macOS 用 brew install hugo；Windows 用 choco install hugo -confirm 或 scoop install hugo；Linux 用 sudo apt install hugo 或下载二进制包解压后移动到 /usr/local/bin。安装后用 hugo version 验证。
怎么给 Hugo 博客添加评论功能？
推荐使用 Giscus（基于 GitHub Discussions）。先在 giscus.app 配置，然后在 config.toml 中添加 [params] enableGiscus = true 以及 [params.giscus] 下的 repo、repoId、category、categoryId、mapping、lang 等参数。
Hugo 博客如何部署到 GitHub Pages？
创建仓库 <username>.github.io，在项目根目录将 public/ 和 resources/ 加入 .gitignore，然后可以编写 deploy.sh 脚本手动部署，或配置 GitHub Actions 自动部署（push 到 main 分支后自动构建并发布）。
Hugo 有哪些 SEO 优化措施？
Hugo 自动生成 sitemap.xml 和 RSS（index.xml），可提交到搜索引擎；添加 robots.txt 并指向 sitemap；在文章中使用 JSON-LD 结构化数据（BlogPosting）提升 SEO 友好度。
如何对 Hugo 博客进行性能优化？
启用图片懒加载（[params] lazyImage = true）；使用 hugo --minify 压缩 HTML/CSS/JS；将静态资源放到 CDN（如 jsDelivr、Cloudflare）；在 PaperMod 主题中启用 PWA（[params] enablePWA = true）。
Hugo 文章不显示怎么办？
检查文章 front matter 中 draft 是否为 false（草稿不显示）；检查日期是否为未来时间（默认会过滤）；检查 hugo.toml 中 buildFuture 和 buildExpired 的设置。
