弃用主题和插件中的 .hbs 文件扩展名

[david (David Taylor)]

在最新版本的 Discourse 中，在主题和插件中使用 .hbs 文件已被弃用。对该文件格式的支持将在下一次 ESR 版本发布后移除。

Handlebars 模板应替换为更现代的 .gjs 格式，这提供了更好的开发体验，并将为未来版本的 Discourse 实现大幅的性能提升。

您可以使用以下说明自动更新您的主题或插件：

Automatically updating themes and plugins to .gjs file format

In the latest version of Discourse’s standard linting config, we’ve enabled the require-strict-mode ember-template-lint rule. This will raise a linting error for any .hbs files. To resolve the warnings, you should convert all your component, route, and connector templates to .gjs files. To make this easy, we’ve built the discourse-gjs-codemod, which builds on top of Ember’s @embroider/template-tag-codemod. To use the codemod, first ensure that your linting dependencies are up-to-date by copyin…

[RGJ (Richard - Communiteq)]

@david

在下一次 ESR 发布之后

我理解正确吗？2026.7 版本仍然支持 hbs 文件，而 2027.1 将是第一个不支持 hbs 文件的 ESR 版本？

[david (David Taylor)]

是的，完全正确。

我们很有可能在 2026.8.0-latest 中停止支持。但这可能稍晚一些，具体取决于实际数据和社区的反馈。