跳转至主内容

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/* 包。

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