跳到主要内容
版本：2.1.0

📦 plugin-debug

The debug plugin will display useful debug information at http://localhost:3000/__docusaurus/debug.

本插件适合插件作者使用，方便检视 .docusaurus 文件夹中的内容（比如创建的路由），和不会写入文件系统中的数据结构，比如通过 contentLoaded 生命周期加载的插件数据。

信息

如果你是通过经典预设使用这个插件，那么预设会默认 (debug: undefined) 在开发环境下启用插件，并在生产环境下禁用插件，避免暴露可能的敏感信息。 你可以用 debug: true 始终启用它，或者用 debug: false 始终禁用它。

如果你用的是独立插件，你可能需要通过检查环境来实现同样的效果：

docusaurus.config.js
module.exports = {
  plugins: [
    process.env.NODE_ENV === 'production' && '@docusaurus/plugin-debug',
  ].filter(Boolean),
};
备注

如果你报告了一个漏洞，我们可能会要求你在网站的生产环境中开启此插件，让我们能更方便地检查你的开发配置。

如果你没有敏感信息的话，你可以像我们一样在生产网站上一直开着这个插件。

安装流程​

npm install --save @docusaurus/plugin-debug
提示

如果你已经安装了 @docusaurus/preset-classic，就不需要安装这个包了。

你可以通过预设选项来配置这个插件。

配置​

这个插件目前没有选项。

示例配置​

你可以通过预设选项或插件选项来配置这个插件。

提示

大多数 Docusaurus 用户通过预设选项配置此插件。

If you use a preset, configure this plugin through the preset options:

docusaurus.config.js
module.exports = {
  presets: [
    [
      '@docusaurus/preset-classic',
      {
        debug: true, // 在生产环境启用插件
      },
    ],
  ],
};