修复 Node.js 环境变量读取为 undefined 的问题
· 阅读需 3 分钟
TL;DR
模块顶层 const URL = process.env.SERVICE_URL 在 dotenv 加载前就执行了，导致值为 undefined。改用 getter 函数 const getUrl = () => process.env.SERVICE_URL 延迟读取。
25 篇博文 含有标签「Bug修复」
查看所有标签修复 Docusaurus 英文版页面链接丢失语言前缀问题
· 阅读需 3 分钟
TL;DR
在 Docusaurus i18n 网站中，使用 <a href="/docs/xxx"> 绝对路径会在英文版页面跳转到中文版。解决方案：页面内链接用 <Link to="/docs/xxx">，MD 文档内用相对路径 ./xxx。
修复 Docusaurus 3.9 翻译文件验证错误
· 阅读需 2 分钟
TL;DR
Docusaurus 3.9 对翻译文件格式有严格要求，code.json 和 current.json 中的值必须是 { "message": "xxx" } 对象格式，不能是纯字符串或嵌套对象。
修复 Docusaurus 引入 Tailwind 后标题样式丢失
· 阅读需 2 分钟
TL;DR
Docusaurus 项目引入 Tailwind CSS 后，markdown 文档中的标题（h1-h6）会失去默认样式。原因是 Tailwind Preflight 重置了所有标题的 font-size 和 font-weight。在 custom.css 中使用 .markdown 选择器手动恢复即可。
修复 Docusaurus Rspack 构建后 Logo 尺寸异常
· 阅读需 2 分钟
TL;DR
Docusaurus 切换 Rspack 构建后，Navbar Logo 可能显示原始图片尺寸覆盖页面。在 custom.css 中显式覆盖 .navbar__logo 样式即可解决。