重命名/docs子文件夹及文件后导航可见文本未同步更新问题

常见原因及修复方式 #

• 缓存残留：浏览器或文档站点生成器（如Docusaurus、VuePress）缓存了旧的导航数据。
  • 操作：强制刷新浏览器（Ctrl+Shift+R / Cmd+Shift+R），执行站点生成器的缓存清理命令（如npm run clean）后重新构建部署。
• 导航配置未同步：多数文档站点的导航文本由配置文件（如sidebars.js、nav.config.js）定义，不会自动随文件夹/文件名变更。
  • 操作：找到项目中的导航配置文件，将对应条目显示文本修改为新名称，重新构建部署。
• 文档元数据未更新：部分框架的导航文本取自文档头部的frontmatter字段（如title、sidebar_label），而非文件名。
  • 操作：打开对应文档文件，更新头部的相关元数据字段，确保与新文件名一致。
• 部署未触发完整更新：托管平台（如GitHub Pages、Netlify）可能未完全替换旧的构建产物。
  • 操作：手动触发重新部署，确认新构建文件已覆盖旧资源。

验证流程 #

1. 本地重新构建并启动服务，确认导航文本在本地环境正常更新，排除部署环节问题。
2. 核对导航配置文件和文档元数据，确认所有相关文本已修改。
3. 清理浏览器缓存后再次访问线上站点。

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