# Discourse 主题中的版本列表无效

**URL:** https://meta.discourse.org/t/invalid-version-list-in-discourse-themes/407855
**Category:** Self-hosting
**Created:** [2026年七月17日 03:37 UTC](https://meta.discourse.org/t/invalid-version-list-in-discourse-themes/407855 "2026-07-17T03:37:28Z")
**Posts on this page:** 1
**Showing post:** 5

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [2026年七月17日 09:26 UTC](https://meta.discourse.org/t/invalid-version-list-in-discourse-themes/407855/5 "2026-07-17T09:26:15Z")

</div>

这将停止记录仅包含注释的文件的警告：

> <https://github.com/discourse/discourse/pull/41804>

`.discourse-compatibility` 仍然受支持，尽管我们现在建议遵循基于 `d-compat/*` 分支的主题/插件兼容性策略。更多详情见此处：

> [@为旧版 Discourse 安装锁定插件和主题版本（d-compat 分支）](https://meta.discourse.org/t/272665):
>
> open_book 背景 主题和插件开发者通常希望针对 Discourse 的 latest 版本进行开发，而无需担心向后兼容性。但运行旧版 Discourse 的网站仍然需要能够正常工作的主题/插件版本。 为了弥合这一差距，可以告知 Discourse 检出主题/插件的旧版“固定”版本。有两种机制可实现此目的，按以下顺序检查： 主题/插件仓库中的 d-compat/\<YYYY\>.\<M\> Git 分支（主要方法——推荐用于所有新固定版本）。 仓库根目录中的 .discourse-compatibility YAML 文件（原始机制，仍作为后备方案支持）。 如果两者都存在，则分支优先。 herb d-compat/\<YYYY\>.\<M\> 分支系统 Discourse 发布使用基于日期的版本号，如 2025.5、2025.6 等。当 Discourse 从 Git 更新插件或主题时，它会询问仓库：「您是否有与我版本匹配的名为 d-compat/\<YYYY\>.\<M\> 的分支？」（例如，针对 Discourse 2025.5.x，分支名为 d-compat/2025.5）。如果…

因此，如果您的文件中没有任何实际条目，建议将其删除。

---

_[View the full topic](https://meta.discourse.org/t/invalid-version-list-in-discourse-themes/407855)._