Ctrl+Click跳转失效的根本原因是VS Code语言服务未识别路径为可跳转模块，需jsconfig.json/tsconfig.json正确配置baseUrl和paths；Path Intellisense通过文件系统映射补足，但仅对补全路径生效；跳转历史依赖主动导航动作，CodeTour仅作语义导览不替代F12。
为什么 Ctrl+Click 跳转失效，而路径明明写对了？
根本原因不是路径错，而是 VS Code 的语言服务没识别出该路径属于可跳转模块。它依赖 jsconfig.json 或 tsconfig.json 提供的 baseUrl 和 paths 配置来解析别名（如 @/utils），否则一律当普通字符串处理。
常见失效场景：
-
jsconfig.json放错位置（必须在项目根目录，不是 src 下） -
paths中的通配符写成"@/*": ["src"]（缺/*，应为["src/*"]） - TypeScript 项目用了
tsconfig.json，但没启用"include"或"exclude"，导致语言服务未加载 src 文件 - 文件刚新建，VS Code 还没触发类型服务重载（重启窗口或运行
Developer: Restart Language Server）
Path Intellisense 插件如何补足原生跳转短板？
Path Intellisense 不替代语言服务，而是绕过它，在编辑器层直接做路径补全和跳转。它不依赖 tsconfig.json，只认文件系统真实结构，所以对 @/ 别名的支持需要额外配置。
关键配置项（在 VS Code 设置中）：
-
path-intellisense.mappings：手动映射别名到物理路径，例如{"@": "${workspaceFolder}/src"} -
path-intellisense.autoSlashAfterDirectory：设为true，输入@/compo后自动补/ -
path-intellisense.extensionOnImport：设为true，补全时自动加.ts或.vue扩展名
注意：Path Intellisense 的 Ctrl+Click 跳转只对它补全过的路径生效；手敲的 @/xxx 若未被它接管，仍会失败。
跳转历史记录为何有时“断连”？
VS Code 的导航堆栈（Alt+← / Alt+→）只记录“有意义”的跳转点，比如 F12、Ctrl+Click、Go to Symbol 等主动导航动作。单纯滚动、点击行号、或搜索结果页里点文件名，不会入栈。
容易被忽略的断裂点：
- 在搜索结果页（Ctrl+Shift+F）点击右侧文件名 → 只打开文件，不入栈；必须点左侧行号才入栈
- 从终端执行
code --goto file.ts:42打开文件 → 光标定位成功，但不计入导航历史 - 使用 Project Manager 插件切换工作区后，旧工作区的跳转历史立即清空
- 多根工作区中，跨文件夹跳转（如从 folderA 的文件跳到 folderB 的定义）可能不被完整追踪
CodeTour 能否替代传统跳转？
不能替代，但能补充。CodeTour 是人为编排的“线性导览”，本质是把文件路径 + 行号 + 文字说明打包成 JSON 存在 .tours/ 目录下，点击 tour 步骤时强制跳转——它不依赖语言服务，也不进导航堆栈，更不参与符号解析。
适用场景明确：
- 新人上手文档：用 tour 记录核心文件职责，比如
[GameRenderer](src/control/GameRenderer.cpp)点击即跳 - 重构过渡期：标记待删除的旧模块路径，附说明“请优先使用
new/Renderer.ts” - CI/CD 流程说明：tour 步骤指向
.github/workflows/deploy.yml#L25
它不解决日常开发中的“按需跳转”，只是给固定路径加一层可交互的语义包装。真要查一个变量在哪定义，还是得靠 F12 和语言服务。
