Hexo RSS 部署指南

一、安装 RSS 插件

Hexo 官方推荐插件：hexo-generator-feed

1	npm install hexo-generator-feed --save

二、配置_config.yml

在站点根目录 _config.yml 中添加：

feed:
  type: atom       # RSS 类型：atom 或 rss2
  path: atom.xml   # RSS 文件生成路径
  limit: 20        # RSS 显示的文章数量
  hub:
  content: true    # 是否输出全文

确保站点 URL 配置正确：

1	url: https://你的域名

三、文章摘要设置（可选）

在文章中使用  标记，RSS 只显示该标记之前内容。
如果希望 RSS 显示全文，保持 content: true 即可。

四、生成 RSS 文件

执行 Hexo 命令生成并部署：

1
2
3

hexo clean   # 清理旧文件
hexo g       # 生成静态文件
hexo d       # 部署到服务器

部署完成后，RSS 地址通常为：

1	https://你的域名/atom.xml

五、RSS 类型选择

类型	说明
atom.xml	推荐现代标准
feed.xml	一般兼容写法
rss2.xml	传统标准，可兼容旧系统

通常建议使用 atom.xml。

六、进阶配置（可选）

控制文章数量：

1 2	feed: limit: 10

只显示摘要：

1 2	feed: content: false

提交 RSS 到平台：

将 RSS 地址提交到：

搜索引擎（Bing / Google）
RSS 阅读器（Feedly / Inoreader / Follow）

七、部署建议

每次更新文章后，执行：

1	hexo clean && hexo g && hexo d

确保 RSS 文件同步最新文章。

八、简单描述我遇到的问题

在使用 Hexo 搭建博客并开启 RSS 订阅后，我遇到了一些非常“玄学”的问题：

删除文章后，RSS 中仍然存在
修改作者信息后，没有覆盖旧内容，反而出现两条记录（不同作者）
RSS 内容与网站实际内容不一致

看起来像是 Hexo 没更新，但其实问题并不在 Hexo 本身。

问题原因

核心原因其实只有一个：

❗ 缓存（Cache）

常见的缓存来源包括：

浏览器缓存
浏览器可能缓存了旧的 RSS 文件（如 atom.xml）
RSS 阅读器缓存
很多 RSS 客户端刷新频率较低，甚至会长期缓存旧数据
CDN / 本地缓存
如果使用了 CDN（如 GitHub Pages / Cloudflare），也可能存在缓存延迟

需要明确一点：

✅ Hexo 每次执行生成（hexo g）时，RSS 文件一定是最新的
❗ 你看到的“旧内容”，几乎都是缓存导致的

解决办法

最简单粗暴、同时也是最有效的方法：

👉 修改 RSS 文件路径，绕过所有缓存

修改配置文件

编辑hexo根目录的_config.yml（不是 .xml，也不是主题的_config.yml，请注意）：

1
2
3

feed:
  type: atom
  path: atom.xml

修改为：

1
2
3

feed:
  type: atom
  path: atom2.xml

（路径可以随意，例如 feed.xml、rss.xml 等）

重新生成并部署

执行：

1	hexo clean && hexo g && hexo d

使用新的订阅地址

新的 RSS 地址变为：

1	https://www.example.com/atom2.xml

重新添加到你的 RSS 阅读器即可。

关于 RSS 的一些建议

不要频繁更换地址

RSS 地址一旦更换，已有订阅基本会失效。
👉 只有在缓存严重问题时再修改路径。

使用标准路径

推荐使用：

atom.xml（首选）
rss.xml
feed.xml

对 RSS 阅读器以及 Google、Microsoft Bing 更友好。

更新后记得清缓存

很多问题不是 RSS，而是 Hexo 本地缓存：

1	hexo clean && hexo g && hexo d

避免重复文章

不要随意修改：

永久链接（文章的固定网址）
文章路径

否则 RSS 可能识别为新文章，出现重复。

RSS 出问题，90% 是缓存问题，10% 是配置问题。

九、最后附上我的 RSS 地址

👉 https://www.dingview.top/atom.xml

欢迎订阅