You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Docusaurus无法识别已翻译Markdown文件问题求助

问题排查与解决

这是你的配置问题,不是Docusaurus的bug,按以下步骤检查修复:

1. 修正baseUrl配置

打开docusaurus.config.js,确认baseUrl设置是否正确:

  • 你的本地访问URL出现/website/,说明baseUrl被配置成了'/website/',但实际你的项目根目录就是website文件夹,Docusaurus启动时会以此为根路径,所以baseUrl应该设为'/'。
  • 错误的baseUrl会导致语言切换时路径拼接异常,进而出现重复追加语言代码de的问题。

2. 验证i18n文档配置

在docusaurus.config.js的i18n字段下,确保docusaurus-plugin-content-docs的本地化配置正确启用:

i18n: {
  defaultLocale: 'en',
  locales: ['en', 'de'],
  localeConfigs: {
    en: { label: 'English' },
    de: { label: 'Deutsch' },
  },
},

无需额外修改docs插件的路径配置,保持默认即可让Docusaurus自动读取i18n/下的本地化文档。

3. 清理缓存重启服务

执行以下命令清理缓存并重新启动开发服务,避免缓存残留导致路由生成异常:

npm run clear
npm run start

内容的提问来源于stack exchange,提问作者Sven

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.06 14:52:03