<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>静态站点 on 今天也要好好吃饭</title><link>https://huangth.xyz/tags/%E9%9D%99%E6%80%81%E7%AB%99%E7%82%B9/</link><description>Recent content in 静态站点 on 今天也要好好吃饭</description><generator>Hugo -- 0.169.0</generator><language>zh-cn</language><copyright>就暮</copyright><lastBuildDate>Thu, 12 Nov 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://huangth.xyz/tags/%E9%9D%99%E6%80%81%E7%AB%99%E7%82%B9/index.xml" rel="self" type="application/rss+xml"/><item><title>Hugo 与 Hexo：两种静态博客生成器的取舍</title><link>https://huangth.xyz/posts/hugo-vs-hexo/</link><pubDate>Thu, 12 Nov 2026 00:00:00 +0800</pubDate><guid>https://huangth.xyz/posts/hugo-vs-hexo/</guid><description>把博客从 Hexo 7 迁移到 Hugo 之后的一些对比：构建方式、性能量级、主题生态、内容组织与部署成本，以及各自的适用场景。</description><content:encoded><![CDATA[<p>本站的前一版是 Hexo 7.3.0，现在跑在 Hugo 0.169 上。两者都是静态站点生成器，最终产物也相同——一堆 HTML、CSS 和 JavaScript，丢给 Nginx 或任意静态托管就能访问。差别不在结果，而在实现路径和日常使用的手感。</p>
<p>这篇把迁移前后的观察整理一下，给同样在做选型的人一个参考。</p>
<h2 id="一架构运行时依赖与单二进制">一、架构：运行时依赖与单二进制</h2>
<p>这是两者最根本的分歧。</p>
<p>Hexo 是一个 Node.js 应用。渲染 Markdown 靠 <code>hexo-renderer-marked</code>，生成页面靠 <code>hexo-generator-index</code> 之类的插件，部署靠 <code>hexo-deployer-*</code>。这套设计让能力可以无限扩展，代价是项目必须带着一棵 <code>node_modules</code>，并且要维护依赖版本。</p>
<p>Hugo 是一个用 Go 编译出的单文件程序。模板引擎、Markdown 渲染、图片处理、多语言、分类系统都是内建的，运行时不需要任何外部依赖。</p>
<table>
	<thead>
			<tr>
					<th></th>
					<th>Hexo</th>
					<th>Hugo</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>运行环境</td>
					<td>Node.js</td>
					<td>无（单个可执行文件）</td>
			</tr>
			<tr>
					<td>扩展方式</td>
					<td>npm 插件</td>
					<td>内建功能 + 模板</td>
			</tr>
			<tr>
					<td>依赖管理</td>
					<td><code>package.json</code> / <code>node_modules</code></td>
					<td>无</td>
			</tr>
			<tr>
					<td>安装耗时</td>
					<td>装依赖通常数十秒到数分钟</td>
					<td>下载解压，秒级</td>
			</tr>
	</tbody>
</table>
<p>这个差异在本地开发时不算明显，但在 CI 里会被放大：Hexo 每次构建都要 <code>npm install</code>，Hugo 只需要一个二进制文件。</p>
<h2 id="二构建速度">二、构建速度</h2>
<p>Hugo 的速度来自并发渲染和编译型语言。本站目前二十来个页面，全量构建耗时约 <strong>0.06 秒</strong>——快到不太像在“构建”，更像是保存文件。</p>
<p>Hexo 在相同页面量级下通常是数秒，具体取决于插件数量：每多一个生成器、一个渲染器，就多一层遍历。这个数字在小站上无感，但文章数到几百上千之后，差距会从“几秒”拉大到“几十秒对不到一秒”，热更新时的体感差异尤其明显。</p>
<p>需要说明的是，这不是“Hexo 慢”的评价，而是两种技术路线的必然结果。如果你的站点只有几十篇，两者都足够快。</p>
<h2 id="三主题与生态">三、主题与生态</h2>
<p>Hexo 的优势在中文本土化。NexT、Butterfly、Fluid 这些主题在国内用户里积累了大量文档和二次开发案例，遇到问题容易搜到答案；插件市场也覆盖了访问统计、文章加密、字数统计这类具体需求。</p>
<p>Hugo 的主题数量更多，但质量分布不均。本站用的「极简 jijian」基于 PaperMod 二次开发，属于中文优化做得比较细的一类；而更常见的通用主题，往往需要自己补一些中文排版细节。</p>
<p>两者的取舍是：<strong>Hexo 更接近“装好就能用”，Hugo 更接近“给你零件自己装”</strong>。前者省时间，后者上限高，前提是你愿意读模板文档。</p>
<h2 id="四内容组织">四、内容组织</h2>
<p>写作层面的差异比想象中大。</p>
<p>Hexo 的约定是 <code>source/_posts/</code> 放 Markdown，开启 <code>post_asset_folder</code> 后，同名的资源目录会自动关联，图片路径写相对文件名即可。</p>
<p>Hugo 用 <strong>Page Bundle</strong>：把一篇文章做成一个目录，正文是 <code>index.md</code>，图片、附件放在同级目录里。这样资源和正文绑定在一起，迁移和引用都更干净。</p>
<p>Front Matter 都是 YAML，但字段名不同，迁移时要逐一对照：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="c"># Hexo</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l">标题</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">date</span><span class="p">:</span><span class="w"> </span><span class="ld">2026-11-12</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">categories</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span>- <span class="l">技术</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">tags</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span>- <span class="l">Hugo</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># Hugo</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="l">标题</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">date</span><span class="p">:</span><span class="w"> </span><span class="ld">2026-11-12</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">categories</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;技术&#34;</span><span class="p">]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">tags</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;Hugo&#34;</span><span class="p">]</span><span class="w">
</span></span></span></code></pre></div><p>此外 Hugo 的 shortcode 机制比 Hexo 的 tag 插件更灵活，可以带参数、嵌套调用，适合做提示框、图注、媒体嵌入这类结构化内容。代价是要学一点 Go template 语法。</p>
<h2 id="五部署与运维">五、部署与运维</h2>
<p>两者的产物都是 <code>public/</code>，部署方式没有本质区别：推仓库、走 CI、同步到服务器或对象存储。</p>
<p>区别在构建环节的复杂度。Hexo 的 CI 需要 Node 环境、<code>npm install</code>、缓存依赖；Hugo 只需要下载二进制——这也是为什么大多数 CI 模板里 Hugo 的配置往往只有三四行。</p>
<p>本站目前的流程是：<code>git push</code> 触发 Actions，构建 Hugo 站点、生成 Pagefind 搜索索引、用 <code>rsync</code> 同步到自己的服务器，全程约三十秒。</p>
<h2 id="六迁移成本">六、迁移成本</h2>
<p>从 Hexo 换到 Hugo 不是改个配置就能完成的事，实际要处理的有：</p>
<ul>
<li><strong>Front Matter 字段</strong>：分类、标签的写法，以及自定义字段的映射</li>
<li><strong>图片路径</strong>：<code>post_asset_folder</code> 的引用方式要改成 Page Bundle</li>
<li><strong>固定链接</strong>：<code>permalink</code> 规则不同，老文章的外部链接可能失效，需要配置 <code>aliases</code> 或重定向</li>
<li><strong>主题功能</strong>：评论、统计、目录这些原由插件承担的部分，要换成 Hugo 的内建配置或模板实现</li>
</ul>
<p>所以迁移前建议把旧站以分支或独立目录的形式保留一段时间，确认新站没有问题再下线路由。本站就把旧站留在了 <code>legacy-hexo</code> 分支。</p>
<h2 id="七怎么选">七、怎么选</h2>
<table>
	<thead>
			<tr>
					<th>你的情况</th>
					<th>建议</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>只写文章，希望装好就能用</td>
					<td>Hexo</td>
			</tr>
			<tr>
					<td>文章量大，或对构建速度敏感</td>
					<td>Hugo</td>
			</tr>
			<tr>
					<td>依赖某个 Hexo 专属插件或主题</td>
					<td>Hexo</td>
			</tr>
			<tr>
					<td>不想维护 Node 依赖，部署环境越简单越好</td>
					<td>Hugo</td>
			</tr>
			<tr>
					<td>愿意读模板、想深度定制样式和结构</td>
					<td>Hugo</td>
			</tr>
			<tr>
					<td>团队更熟 JavaScript</td>
					<td>Hexo</td>
			</tr>
	</tbody>
</table>
<p>一句话概括：突然来兴趣了，所以就用hugo了。</p>
]]></content:encoded></item></channel></rss>