Canary 版本

Docusaurus 提供 Canary 版本。

您可以在合并代码后立刻测试未发布的全新功能。

这有助于您向维护者们提交反馈，确保新实现的功能正常工作。

note

实际上，在生产环境中使用 Canary 版本并不存在风险。

Canary 版本通过了所有的自动化测试，就连本网站的生产环境中也在使用此版本。

Canary npm 版本标签

对于在 main中的任何与代码相关的提交， 持续集成 (CI) 将通过 NPM 的 @canary 版本标签发布新版本。 这一般需要 10 分钟左右。

你可以在 NPM 上看到当前的版本标签：

• latest: 稳定版本（例如：2.0.0-beta.0）
• canary: 金丝雀版本（例如：0.0-1234）

tip

确保使用最新的金丝雀版本，并检查发行日期（有时发布过程可能会失败）。

note

Canary 版本遵循 0.0.0-commit 编号 的命名规范。

使用 Canary 版本

举个例子，假如当前 NPM 金丝雀版本标签 下发布的最新版本是 0.0.0-1234。

用它替换你的 package.json 里的所有 @docusaurus/* 依赖项：

- "@docusaurus/core": "^2.0.0-beta.0",
- "@docusaurus/preset-classic": "^2.0.0-beta.0",
+ "@docusaurus/core": "0.0.0-1234",
+ "@docusaurus/preset-classic": "0.0.0-1234",

然后重新安装依赖，并启动你的网站：

npm install
npm start

你也可以用命令行更新 @docusaurus* 相关的包：

npm install --save-exact @docusaurus/[email protected] @docusaurus/[email protected]

caution

确保包含所有 @docusaurus/* 包。

对于金丝雀版本，建议使用精确版本，而不是语义版本范围（避免 ^ 前缀）。