能否以开发模式构建含草稿页的Docusaurus v2站点？

DevOps 小满

2026-7-27

解决Docusaurus v2构建包含草稿页的方案

Docusaurus v2没有直接的--mode=dev参数让yarn build包含草稿页，但可以通过以下几种方式实现需求：

通过环境变量控制草稿页构建
Docusaurus的文档（docs）和博客（blog）插件都支持includeDraft配置项，你可以结合环境变量动态开启这个选项：
1. 修改docusaurus.config.js，在preset配置中加入环境变量判断：
```
module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',
      {
        docs: {
          includeDraft: process.env.DRAFT === 'true',
        },
        blog: {
          includeDraft: process.env.DRAFT === 'true',
        },
      },
    ],
  ],
};
```
1. 执行构建时注入环境变量：
  - 本地构建：DRAFT=true yarn build
  - Netlify构建：直接将构建命令配置为DRAFT=true yarn build，或者在Netlify站点设置的环境变量中添加DRAFT=true，之后用普通的yarn build即可。
添加自定义构建命令
在package.json的scripts里新增专属命令，简化操作：
```
{
  "scripts": {
    "build:preview": "DRAFT=true yarn build"
  }
}
```
之后直接执行yarn build:preview就能生成包含草稿页的生产构建产物。