RSS 语法

RSS 语法最完整速查表（2025 年最新、实际可用版）

RSS 目前最常用的是 RSS 2.0（RSS 2.0.11 规范），几乎所有网站、阅读器、工具都兼容这个版本。下面是 100% 准确、可直接复制使用 的语法规则。

1. 基本骨架（必须这样写）

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <!-- 这里放频道信息和所有条目 -->
  </channel>
</rss>

2. 必填与常用字段（至少要有 3 个必填）

元素	是否必填	示例	说明
</td> <td>必填</td> <td><title>阮一峰的网络日志	网站/播客名称
	必填	https://www.ruanyifeng.com/blog/	网站首页链接
	必填	记录每周值得分享的科技内容	一句话介绍
	推荐	zh-cn	语言
	推荐	Fri, 04 Dec 2025 10:00:00 +0800	频道最近更新时间
	推荐	同上	很多工具只认这个
	推荐	Hugo 0.123.0	生成工具
	推荐	60	缓存时间（分钟）
	可选	见下面	频道图标

3. 字段（一篇文章/一集播客）

元素	是否推荐	示例 & 最佳实践
</td> <td>强烈推荐</td> <td><title>科技爱好者周刊（第 300 期）
	强烈推荐	https://www.ruanyifeng.com/blog/2025/12/weekly-300.html
	强烈推荐	https://…/weekly-300.html
	强烈推荐	Fri, 04 Dec 2025 09:00:00 +0800
	推荐	用 CDATA 保留 HTML：正文摘要…]]>
	强烈推荐	完整正文（推荐使用这个）：
	推荐	mail@example.com (阮一峰)
	可选	科技
	播客必填

4. 2025 年最推荐的完整模板（直接复制就能用）

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" 
     xmlns:atom="http://www.w3.org/2005/Atom"
     xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>阮一峰的网络日志</title>
    <link>https://www.ruanyifeng.com/blog/</link>
    <description>记录每周值得分享的科技内容</description>
    <language>zh-cn</language>
    <lastBuildDate>Fri, 04 Dec 2025 10:00:00 +0800</lastBuildDate>
    <generator>Hugo</generator>
    <ttl>60</ttl>

    <item>
      <title>科技爱好者周刊（第 300 期）</title>
      <link>https://www.ruanyifeng.com/blog/2025/12/weekly-300.html</link>
      <guid isPermaLink="true">https://www.ruanyifeng.com/blog/2025/12/weekly-300.html</guid>
      <pubDate>Fri, 04 Dec 2025 09:00:00 +0800</pubDate>
      <author>ruanyf@gmail.com (阮一峰)</author>

      <!-- 摘要（阅读器列表页显示） -->
      <description><![CDATA[
        <p>这里是文章前 200 字摘要...</p>
        <img src="https://www.ruanyifeng.com/xxx.jpg">
      ]]></description>

      <!-- 完整正文（强烈推荐） -->
      <content:encoded><![CDATA[
        <h2>完整标题</h2>
        <p>这里是整篇文章，支持图片、代码高亮、视频……</p>
        <pre><code class="language-js">console.log('Hello RSS');</code></pre>
      ]]></content:encoded>
    </item>

  </channel>
</rss>

5. 常见错误（99% 的 RSS 失效都因为这几个）

错误类型	正确写法
日期格式写错	必须是 RFC 822：Fri, 04 Dec 2025 10:00:00 +0800
没加 CDATA，HTML 被转义	用 <![CDATA[...]]> 包裹
guid 不是永久链接	推荐和 link 一样 + 加 isPermaLink="true"
没加 content:encoded	大部分阅读器只显示 description，文章不全
编码声明错了	必须 <?xml version="1.0" encoding="UTF-8"?>

一句话总结（2025 年）

写 RSS 只要记住 3 件事：

1. 严格按 RSS 2.0 写（不要用 Atom 冒充）
2. 所有 HTML 必须用 CDATA 包起来
3. 一定要加 <content:encoded> 完整正文

这样写出来的 RSS，所有阅读器（Feedbin、Reeder、FreshRSS、Fluent Reader、ReadYou）都能完美显示。

需要我：

• 给你 Hugo/Hexo/WordPress/VitePress 自动生成完美 RSS 的配置？
• 一个可以直接用的 RSS 校验工具？
• 微信公众号/小红书/YouTube 转标准 RSS 的最新脚本？

直接说，我立刻发你。