版本：3.8.1

自动迁移

迁移 CLI 会自动将您的 v1 网站迁移到 v2 网站。

注意

使用迁移 CLI 后仍需要手动操作，因为我们无法实现完全自动化迁移。

迁移 CLI 迁移以下内容：

站点配置（从 siteConfig.js 到 docusaurus.config.js）
package.json
sidebars.json
/docs
/blog
/static
如果您的站点使用版本控制，则迁移 versioned_sidebar.json 和 /versioned_docs

要使用迁移 CLI，请遵循以下步骤：

在使用迁移 CLI 之前，请确保 /docs、/blog、/static、sidebars.json、siteConfig.js、package.json 遵循预期的结构。
要迁移您的 v1 网站，请使用适当的文件系统路径运行迁移 CLI。

# migration command format
npx @docusaurus/migrate migrate <v1 website directory> <desired v2 website directory>

# example
npx @docusaurus/migrate migrate ./v1-website ./v2-website

要在本地查看您的新网站，请进入 v2 网站的目录并启动开发服务器。

npm
Yarn
pnpm
Bun

cd ./v2-website
npm install
npm start

cd ./v2-website
yarn install
yarn start

cd ./v2-website
pnpm install
pnpm start

cd ./v2-website
bun install
bun start

危险

迁移 CLI 会更新现有文件。请务必先提交它们！

选项

您可以为迁移 CLI 添加选项标志，以自动将 Markdown 内容和页面迁移到 v2。您可能仍需要进行一些手动更改才能达到预期的效果。

名称	描述
`--mdx`	添加此标志可自动将 Markdown 转换为 MDX
`--page`	添加此标志可自动迁移页面

# example using options
npx @docusaurus/migrate migrate --mdx --page ./v1-website ./v2-website

危险

页面和 MDX 的迁移仍在进行中。

我们建议您尝试在不带这些选项的情况下运行页面，提交更改，然后再次尝试使用 --page 和 --mdx 选项运行迁移。

这样，您就能轻松检查并修复差异。

选项​

选项