Docusaurus V2新建站点导航栏默认搜索栏不显示如何解决？

核心原因 #

默认预装的@docusaurus/theme-search-algolia主题的导航栏搜索框组件有渲染条件判断，仅当配置了合法的搜索服务参数时才会显示，预置的/search路由是主题默认注册的，和导航栏组件的显示逻辑相互独立，因此会出现能访问搜索页但看不到导航栏搜索框的情况。

缺失的配置步骤 #

按照你使用的搜索类型选择对应配置方案：

• 使用Algolia云端搜索（默认方案）
  需要在docusaurus.config.js的themeConfig下新增algolia参数配置块，填入你在Algolia后台申请的对应服务参数即可：

  themeConfig: {
    // 原有其他配置保持不变
    algolia: {
      appId: "YOUR_ALGOLIA_APP_ID",
      apiKey: "YOUR_ALGOLIA_PUBLIC_SEARCH_API_KEY",
      indexName: "YOUR_ALGOLIA_INDEX_NAME",
    },
    navbar: {
      // 你已有的导航栏配置保持不变
    }
  }
  

• 使用本地离线搜索（无需Algolia服务）

  1. 先卸载默认的Algolia搜索主题，安装本地搜索插件，执行命令：
     npm remove @docusaurus/theme-search-algolia
npm install @docusaurus/plugin-search-local
  2. 在docusaurus.config.js的plugins数组中添加本地搜索插件配置：

     plugins: [
       [
         '@docusaurus/plugin-search-local',
         {
           // 无特殊需求可直接留空使用默认配置
         },
       ],
     ],
     

配置完成后重启本地开发服务，导航栏搜索框即可正常渲染显示。

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