静态网站因为无需数据库和后端服务，在部署成本和安全性上都有明显优势，Hugo和Jekyll是目前最主流的两类生成器。但很多作者在迁移到静态站后，会忽略一个关键能力：让读者通过RSS阅读器持续获取更新。RSS本质上是一份结构化的XML文件，里面按时间顺序列出站点最新文章的标题、链接、摘要与发布时间，订阅软件每隔一段时间抓取一次该文件即可提醒读者。为静态站添加RSS，并不是引入复杂服务，而是利用生成器在构建阶段把文章元数据渲染成固定格式的feed文件。
为什么静态网站需要手动处理RSS
与WordPress等内容管理系统不同，Hugo和Jekyll在初始化项目时往往不会直接产出符合你预期的RSS文档。Hugo虽自带基础RSS模板，但字段内容和样式未必满足需要；Jekyll在较早版本中甚至完全不包含feed，需要依赖jekyll-feed插件或自行编写模板。如果不显式生成并提供RSS，用户就无法在Feedly、Inoreader等工具中订阅你的站点，只能被动刷网页。
另一个容易被忽视的点是，RSS文件必须保持稳定URL且内容格式合法。静态站每次构建都会重新生成所有页面，只要模板正确，feed就会随文章发布自动更新。这种“构建即更新”的模式比动态站查询数据库更轻量，但也要求作者理解模板语言和XML转义规则，否则容易出现乱码或订阅器报错。
Hugo中添加与定制RSS
Hugo默认在站点根目录输出index.xml作为RSS，前提是配置中开启了相关输出格式。最基础的做法是在config.toml里确保有相关设置，如果不满意默认模板，可以在layouts/_default下新建rss.xml覆盖。下面是一段自定义RSS模板示例，它会遍历最近二十篇文章并输出标准结构。
<?xml version="1.1" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
<channel>
<title>{{ .Site.Title }}</title>
<link>{{ .Site.BaseURL }}</link>
<description>近期文章更新</description>
<generator>Hugo</generator>
<lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" }}</lastBuildDate>
<atom:link href="{{ .Site.BaseURL }}index.xml" rel="self" type="application/rss+xml"/>
{{ range first 20 .Site.RegularPages }}
<item>
<title>{{ .Title }}</title>
<link>{{ .Permalink }}</link>
<pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" }}</pubDate>
<guid>{{ .Permalink }}</guid>
<description>{{ .Summary | html }}</description>
</item>
{{ end }}
</channel>
</rss>
上述代码里使用了Hugo的模板变量，例如.Site.RegularPages代表所有常规页面，.Summary是自动截取的文章摘要。注意摘要部分用html函数做了转义，避免正文里的特殊符号破坏XML结构。如果你希望RSS中包含全文而非摘要，可以把description标签内容换成.Content，但那样会让feed体积变大。
配置完成后执行hugo命令构建，在公开目录查看index.xml是否存在且能被浏览器正常打开。之后在站点头部模板插入一个link标签声明RSS地址，读者用阅读器订阅根域名通常就能自动发现。
Jekyll中通过插件或模板生成feed
Jekyll官方维护的jekyll-feed插件是最省事的选择。只需在Gemfile和_config.yml里添加插件名，构建时就会在根目录生成feed.xml。下面是在配置文件中启用的片段：
plugins: - jekyll-feed
启用后，插件会自动读取站点的标题、描述以及带show_in_feed标记的帖子。它的好处是无需写一行XML，且对分页和分类支持较好。但缺点是可定制性弱，例如想修改输出字段数量或增加自定义命名空间时，往往要覆写插件布局。
若你希望完全掌控，可以手写feed.xml放在根目录，利用Liquid语法遍历文章。示例代码如下：
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>{{ site.title }}</title>
<link>{{ site.url }}</link>
<description>{{ site.description }}</description>
<lastBuildDate>{{ site.time | date_to_rfc822 }}</lastBuildDate>
{% for post in site.posts limit:20 %}
<item>
<title>{{ post.title }}</title>
<link>{{ post.url | absolute_url }}</link>
<pubDate>{{ post.date | date_to_rfc822 }}</pubDate>
<guid>{{ post.url | absolute_url }}</guid>
<description>{{ post.excerpt | xml_escape }}</description>
</item>
{% endfor %}
</channel>
</rss>
这段模板中xml_escape过滤器非常关键，它把摘要里的尖括号等符号转义，防止XML解析失败。Jekyll构建后同样要把feed.xml放到能被访问的位置，并在<head>中通过link标签关联。
让订阅入口可见且合规
生成feed文件只是第一步，用户必须知道它的存在。常见做法是在页面顶部或底部放一个“RSS订阅”文字链接，指向/feed.xml或/index.xml。同时，在HTML的<head>区域加入如下声明，主流阅读器才能自动探测：
<link rel="alternate" type="application/rss+xml" title="站点名称" href="/index.xml" />
此外，RSS地址应当稳定且支持跨域访问。如果你把静态站托管在对象存储或CDN上，要确认对应路径没有被判为目录页而返回错误。可以用W3C的feed校验服务或本地阅读器直接添加URL测试，观察是否能拉到最新十条以上的内容。
当一切就绪，你的Hugo或Jekyll站点就拥有了和大型博客平台同等的订阅能力。读者在手机上点一次订阅，今后每次你推送新文，对方无需访问网页也能收到提醒，这对个人创作者积累长期读者尤其有价值。
常见误区与排查
有人误以为只要把文章列表页的链接发给别人就是RSS，这是概念混淆。RSS必须是机器可读的XML，而不是给人看的HTML列表。另一个误区是在代码块外直接写未转义的<item>等标签，导致页面本身被破坏。记住正文中提及标签名时要写成<item>这样的转义形式，只有模板文件内部才写真实尖括号。
如果订阅器报“invalid xml”，多半是某篇文章标题含未转义的&符号或摘要里嵌了原始HTML。检查模板是否对所有动态内容使用了转义过滤器，并在本地用浏览器打开feed文件确认能正常渲染。只要保持生成逻辑简单并每次构建后自测，静态站的RSS就能长期稳定运行。
RSSstatic_site_generatorHugo修改时间：2026-08-04 09:12:39