RSS channel元素

RSS <channel> 元素最全详解(RSS 2.0 规范,2025 年实际使用版)

<channel> 是 RSS 文件中唯一且必须的顶级容器,代表「一个订阅源」(一个博客、一个播客、一个新闻频道等)。
所有 <item> 都必须放在 <channel> 里面。

1. 基本结构(最小可用版本)

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>必填:订阅源标题</title>
    <link>必填:网站首页地址</link>
    <description>必填:一句简介</description>

    <!-- 这里放无数个 <item> -->
    <item>...</item>
    <item>...</item>
  </channel>
</rss>

2. 全部可用子元素(2025 年实际兼容性排序)

元素是否必填说明 & 2025 年推荐写法
</td> <td>必填</td> <td>订阅源名称,例如:阮一峰的网络日志</td> </tr> <tr> <td><link></td> <td>必填</td> <td>网站首页完整 URL(必须能直接打开),例如:https://www.ruanyifeng.com/blog/</td> </tr> <tr> <td><description></td> <td>必填</td> <td>一句介绍,支持 HTML,但建议纯文字,最好 ≤ 200 字</td> </tr> <tr> <td><language></td> <td>推荐</td> <td>如 zh-cn、en-us、ja 等</td> </tr> <tr> <td><copyright></td> <td>可选</td> <td>版权声明,例如:Copyright 2025 阮一峰</td> </tr> <tr> <td><managingEditor></td> <td>可选</td> <td>编辑邮箱(name@example.com (张三))</td> </tr> <tr> <td><webMaster></td> <td>可选</td> <td>站长邮箱</td> </tr> <tr> <td><pubDate></td> <td>推荐</td> <td>频道首次发布日期(RFC 822 格式)</td> </tr> <tr> <td><lastBuildDate></td> <td>强烈推荐</td> <td>最后更新时间(几乎所有阅读器都只认这个)!!!</td> </tr> <tr> <td><category></td> <td>可选(可多个)</td> <td>分类,例如 <category>科技</category></td> </tr> <tr> <td><generator></td> <td>推荐</td> <td>生成工具,例如:Hugo 0.134.0、WordPress 6.6、Hexo</td> </tr> <tr> <td><docs></td> <td>可选</td> <td>通常写:https://www.rssboard.org/rss-specification</td> </tr> <tr> <td><ttl></td> <td>强烈推荐</td> <td>缓存分钟数,建议 30~1440,国内博客常用 60</td> </tr> <tr> <td><image></td> <td>可选</td> <td>频道 Logo(见下表)</td> </tr> <tr> <td><rating></td> <td>已废弃</td> <td>基本没人用</td> </tr> <tr> <td><textInput></td> <td>已废弃</td> <td>没人用</td> </tr> <tr> <td><skipHours> / <skipDays></td> <td>可选</td> <td>告诉阅读器什么时间不更新(很少用)</td> </tr> <tr> <td><cloud></td> <td>已废弃</td> <td>早期推送用,现在没人用</td> </tr> <tr> <td><atom:link></td> <td>强烈推荐</td> <td>2025 年必加!用于自我发现(见最佳实践)</td> </tr> </tbody> </table> <h4>3. <image> 子元素(频道 Logo)完整写法</h4> <pre><code class=”xml language-xml”><image> <url>https://www.ruanyifeng.com/favicon.ico</url> <!– 必填 –> <title>阮一峰的网络日志</title> <!– 必填,通常和 channel title 一样 –> <link>https://www.ruanyifeng.com/blog/</link> <!– 必填 –> <width>144</width> <!– 可选,最大 144 –> <height>144</height> <!– 可选,最大 400 –> <description>阮一峰的网络日志</description> <!– 可选 –> </image></code></pre> <h4>4. 2025 年最推荐的完美 <channel> 模板(直接复制)</h4> <pre><code class=”xml language-xml”><?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:30:00 +0800</lastBuildDate> <generator>Hugo</generator> <ttl>60</ttl> <!– 2025 年必须加这行,让阅读器能自动发现 RSS –> <atom:link href=”https://www.ruanyifeng.com/blog/atom.xml” rel=”self” type=”application/rss+xml” /> <image> <url>https://www.ruanyifeng.com/favicon.ico</url> <title>阮一峰的网络日志</title> <link>https://www.ruanyifeng.com/blog/</link> </image> <!– 这里开始放 <item> –> <item>…</item> </channel> </rss></code></pre> <h4>5. 2025 年最容易出错的 3 个地方(99% 的 RSS 被阅读器显示不正常都因为这几个)</h4> <table> <thead> <tr> <th>错误</th> <th>正确写法</th> </tr> </thead> <tbody> <tr> <td>没有 <lastBuildDate></td> <td>必须加,且每次更新都要改时间</td> </tr> <tr> <td>没有 <atom:link rel=”self”></td> <td>2024 年后几乎所有新阅读器都要求有这行</td> </tr> <tr> <td><link> 写成相对路径</td> <td>必须是完整的 https:// 开头绝对路径</td> </tr> </tbody> </table> <p>记住这三点,你的 RSS 在 Reeder、NetNewsWire、Feedbin、FreshRSS、ReadYou、Fluent Reader 等所有主流阅读器里都能完美显示。</p> <p>需要我给你:</p> <ul> <li>WordPress/Hexo/Hugo/VitePress/Typecho 2025 年最新完美 RSS 配置?</li> <li>一个在线校验工具,能立刻告诉你你的 <channel> 哪里写错了?</li> </ul> <p>直接说一声,马上发你。</p>
文章已创建 2965

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

相关文章

开始在上面输入您的搜索词,然后按回车进行搜索。按ESC取消。

返回顶部