Codex调试前端项目时需同步清理路由注册层、构建产物层、缓存索引层三处失效路由：先通过http://localhost:3000/__codex/routes诊断确认component: null或file not found的路由，再手动或用codex scan routes --orphan-only定位并删除，最后清除.vite/dist/.next、~/.codex/shell_snapshots/中相关缓存并执行codex-index reset --domain=router重建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex在调试前端项目时，若检测到路由定义与实际页面组件不匹配、或存在已删除页面但仍被路由表引用的情况，会导致开发服务器热更新异常、404跳转失效、甚至影响AI生成代码的上下文准确性——必须从路由注册层、构建产物层、缓存索引层三处同步清理。
确认失效路由是否真实存在
先验证当前项目中哪些路由是“名义存在但实际不可达”：打开终端，进入项目根目录，运行 npm run dev（或 pnpm dev）启动本地服务；在浏览器访问 http://localhost:3000/__codex/routes（Codex 内置路由诊断端点）。该页面会列出所有被识别的路由路径、对应文件路径、是否匹配组件导出、以及最后修改时间戳。若某条路由显示 component: null 或 file not found，即为待清理目标。
注意：不要仅凭 src/router/index.ts 中的 routes 数组判断——Codex 可能已通过插件自动注入动态路由，这些不会出现在源码中，但会出现在诊断页里。
从路由注册表中移除失效条目
方法一：手动编辑路由配置文件
打开 src/router/index.ts（或 src/router/routes.ts），查找所有 path 值指向已删除页面的路由对象，例如：{ path: '/dashboard/legacy', component: () => import('@/views/LegacyDashboard.vue') }。
确认 @/views/LegacyDashboard.vue 文件确实不存在（用 ls -l src/views/LegacyDashboard.vue 验证），则整行删除该路由定义。
立即学习“前端免费学习笔记（深入）”；
将来自 Marvis 或微信的可信远程软件开发请求中继至用户本地的 Codex CLI，等待编码任务完成，并返回经验证的结果。当用户通过 Codex 要求 Marvis 检查、实现、修复、测试、review 或继续在明确指定的本地项目目录中开展工作时，使用此功能。
方法二：用 Codex CLI 批量扫描并标记
在终端中执行：codex scan routes --orphan-only。它会输出类似：⚠️ /admin/analytics → src/views/AnalyticsOld.vue (MISSING)⚠️ /settings/billing → src/views/BillingV1.vue (DELETED)
将输出中所有带 (MISSING) 或 (DELETED) 的路径复制下来，用 sed -i '' '/\/admin\/analytics/d' src/router/index.ts（macOS）或 sed -i '/\/settings\/billing/d' src/router/index.ts（Linux）逐条删除。
【删除前务必 git add -u && git commit -m "backup routes before cleanup"】——路由误删会导致整个前端导航崩溃，无法回退。
清除构建产物与缓存中的残留引用
第一步：清空 Vite/webpack 构建缓存
运行：rm -rf node_modules/.vite && rm -rf .vite（Vite 项目）或 rm -rf dist && rm -rf .next（Next.js）。
第二步：清理 Codex 自动注入的路由快照
进入 ~/.codex/shell_snapshots/ 目录，执行：find . -name "*route*" -o -name "*router*" | xargs -r rm -f。
这些快照由 Codex 在「路由理解」模式下生成，用于辅助生成跳转逻辑，但一旦源文件删除，快照仍会参与上下文推理，导致 AI 错误推荐已废弃路径。
第三步：重置 Codex 路由索引数据库
执行：codex-index reset --domain=router。该命令会强制 Codex 丢弃当前所有路由元数据，并在下次启动时重新扫描 src/router/ 和 pages/ 目录重建索引——这是防止 AI 继续“记得”失效路由的关键一步。
