如何在Docusaurus本地构建或开发环境中获取站点地图？

官方文档明确说明Sitemap插件仅在生产构建时激活，开发模式（npm run start）下不会生成sitemap.xml，所以直接访问localhost:3000/sitemap.xml会返回404。以下两种方法可以绕过这个限制：

方法1：本地构建后预览生产环境版本 #

这是最直接且不破坏开发体验的方式：

• 执行生产构建命令：npm run build
• 用静态文件服务器预览构建产物：npx serve build
• 访问http://localhost:3000/sitemap.xml即可看到生成的站点地图

这种方式完全模拟生产环境，生成的sitemap和线上版本一致，适合验证配置是否正确。

方法2：强制Sitemap插件在开发模式下运行 #

如果需要在npm run start的热重载环境中查看sitemap，可以通过修改配置和环境变量实现：

1. 在docusaurus.config.js中，修改Sitemap插件配置（部分版本支持forceGenerate参数，若不生效可跳过此步）：

module.exports = {
  plugins: [
    [
      '@docusaurus/plugin-sitemap',
      {
        // 保留你的原有配置
        forceGenerate: true,
      },
    ],
  ],
};

2. 在package.json的scripts中新增带环境变量的启动命令：

{
  "scripts": {
    "start:with-sitemap": "NODE_ENV=production npm run start"
  }
}

3. 执行npm run start:with-sitemap启动站点
4. 访问http://localhost:3000/sitemap.xml即可获取sitemap

注意：这种方式会让Docusaurus以生产模式运行，热重载速度变慢，且部分开发调试功能失效，仅适合临时验证sitemap配置。

注意事项 #

• 无论用哪种方法，sitemap内容都取决于你在docusaurus.config.js中对Sitemap插件的配置（比如排除路径、修改站点URL等）
• 使用方法2后，记得改回原启动命令，避免影响日常开发效率

内容的提问来源于stack exchange，提问作者KWriter