Go to Definition 跳转到 node_modules 声明文件而非本地源码，是因为 TypeScript 模块解析优先匹配 package.json 的 types 字段或 index.d.ts，而非相对路径源码；尤其当存在同名第三方包时会“认错人”，需通过配置 baseUrl/paths、使用 tsc --traceResolution 诊断，并设置 "types": [] 或移除冲突声明文件来强制跳转源码。
为什么 Go to Definition 跳不到源码，却跳到 node_modules 里的声明文件？
这通常不是路径错误，而是 TypeScript 的模块解析策略在起作用：它优先匹配 types 字段或 index.d.ts，而非你本地的源码。尤其当你装了同名 npm 包（比如自己也写了 utils，又装了第三方 utils），TS 就会“认错人”。
实操建议：
- 检查当前文件顶部的
import语句是否显式指向了相对路径（如import { foo } from '../src/utils'），否则默认走 node resolution - 在
tsconfig.json中确认"baseUrl"和"paths"配置是否与实际目录结构一致，路径别漏写/*或多写斜杠 - 运行
tsc --traceResolution查看 TS 实际查找路径（输出极长，但关键行会标出 “Resolved module” 和 “Found candidate”）
如何让 VSCode 明确使用本地源码而非 node_modules 声明？
核心是切断 TS 对第三方类型声明的自动回退。常见于你正在开发一个库，并同时在项目里引用了它的未发布版本。
实操建议：
- 在
tsconfig.json中添加"skipLibCheck": true（仅用于开发期，不解决根本路径问题，但能避免误报） - 用
npm link或yarn link后，在被链接项目中删掉node_modules/your-pkg，再执行yarn add link:../path/to/your-pkg（注意不是file:协议，VSCode 对file:的符号解析支持不稳定） - 在 import 语句后加 JSDoc 注释
// @ts-ignore不解决问题，但// @ts-nocheck会关全局检查——别这么干
Go to References 找不到调用处？检查 jsconfig.json 或 tsconfig.json 的 include
VSCode 的引用搜索依赖语言服务索引，而索引范围由配置文件的 include 字段决定。如果 include 漏掉了测试目录、CLI 脚本或 src/**/* 外的入口文件，那些地方的引用就不可见。
实操建议：
- 确认
include是数组，且至少包含"src/**/*"和"test/**/*"（如有）；不要写成字符串"src/**/*"单项（JSON 语法错误） - 若项目含 ESM + CJS 混合，确保
"allowSyntheticDefaultImports": true和"moduleResolution": "nodenext"（TS 5.0+）匹配，否则 import 语句可能不被识别为有效引用 - 改完配置后必须重启 TS 服务：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入 “TypeScript: Restart TS server”
调试时发现符号路径显示为 xxx.d.ts，但你想看的是 .ts 源文件
这是 TypeScript 语言服务默认行为：当存在 .d.ts 文件时，它认为“类型已完备”，不再加载同名 .ts。即使你本地有 foo.ts，只要 node_modules/foo/index.d.ts 存在，就会优先用后者。
实操建议：
- 临时重命名或移走
node_modules中冲突包的types目录（如node_modules/lodash/types），观察跳转是否恢复正常 - 在
tsconfig.json中设置"declaration": false（仅影响编译，不影响编辑器）无效；真正有效的是"types": []—— 它会禁用所有自动引入的三方类型定义 - 最稳的方式：用
npm install --no-save避免把开发中的包装进node_modules，改用pnpm link或yarn workspace管理单仓多包
路径解析不是纯字符串匹配，而是受 tsconfig.json、package.json 的 exports / types / main、以及 VSCode 缓存三者共同影响。每次怀疑路径出问题，先 Restart TS server，再看 tsc --traceResolution 输出 —— 其他操作都是在猜。
