Canary 版本

Docusaurus 提供 Canary 版本。

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

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

note

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

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

Canary npm 版本标签

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

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

• latest: 稳定版本（例如：2.0.0-beta.9）
• canary: Canary 版本（例如：0.0-4222）

tip

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

note

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

使用 Canary 版本

举个例子，假设当前 Canary 版本的版本标签的最新版本是 0.0.0-4222。

那么，请用此版本替换你的 package.json 里的所有 @docusaurus/* 依赖项：

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

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

npm install
npm start

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

npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary

caution

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

我们建议您在安装 Canary 版本时输入您想要的版本号，而不要使用版本范围（即避免 ^ 前缀）。