根本原因是TypeScript未正确解析pnpm的符号链接路径；需配置pnpm-workspace.yaml、根tsconfig.json启用references及paths映射，子包tsconfig设composite:true，VSCode须打开根工作区并重启TS Server。
pnpm workspace 配置后 Go to Definition 仍跳不到其他包？
根本原因不是 VSCode 没识别 workspace，而是 TypeScript 没正确解析 pnpm 的符号链接路径。pnpm 默认用硬链接 + symlink 实现依赖复用，但 TS 的 baseUrl 和 paths 不会自动适配 workspace 内部的包引用方式。
实操建议：
- 确保根目录有
pnpm-workspace.yaml，且包含合法packages字段（如packages: ["packages/*"]） - 在根目录
tsconfig.json中启用references，每个子包必须有独立tsconfig.json并设置"composite": true - 不要手动改
node_modules/.pnpm下的 symlink 目标——那是 pnpm 自己管的，改了反而破坏类型解析 - VSCode 必须使用工作区根目录打开（即打开含
pnpm-workspace.yaml的文件夹），不能只打开某个子包文件夹
为什么 import { foo } from "my-utils" 跳转失败，但 import { foo } from "../my-utils/src" 可以？
这是典型的模块解析路径未对齐问题：你写了包名导入，但 TypeScript 没把 my-utils 映射到本地源码，而是去 node_modules/my-utils 找（那里只有构建产物，没类型或源码）。
解决方法是让 TS 知道这个包名对应的是 workspace 内的源码路径：
- 在根
tsconfig.json的compilerOptions.paths中添加：{"my-utils": ["packages/my-utils/src"]} - 同时确保子包
packages/my-utils/tsconfig.json的compilerOptions.baseUrl是"./src"或"."（与 paths 中路径匹配） - 删掉
node_modules和.vscode缓存，重启 TS Server（快捷键Ctrl+Shift+P→Restart TS server） - 不推荐用
typesVersions或declarationMap替代——它们解决的是发布后的类型分发，不是本地开发跳转
VSCode 提示 “No definition found for …” 但代码能正常运行？
运行和跳转走的是两套路径：运行靠 Node.js 的 resolver（pnpm 已 patch 过），跳转靠 TypeScript language server。只要 TS 没加载到对应包的 index.d.ts 或源码，就会提示找不到定义。
检查三处关键配置：
-
tsconfig.json中include是否覆盖了子包的源码路径（例如"packages/**/src/**/*"） - 子包
package.json中是否声明了"types": "./dist/index.d.ts"—— 如果你没生成.d.ts，就别写这行，否则 TS 会优先找它而忽略源码 - 确认没有在子包里误加
"type": "module"且没配tsconfig.json的moduleResolution: "bundler"（TS 4.7+ 才支持，老版本会直接放弃解析）
pnpm link 和 workspace: 协议会影响跳转吗？
不影响，而且不该用。pnpm 的 workspace: 协议（如 "my-utils": "workspace:^"）只是安装时的指令，最终生成的仍是标准 symlink。VSCode 和 TS 根本不解析 package.json 里的 workspace:，只看 node_modules 的实际结构和 tsconfig 的路径映射。
真正要避免的是手动 pnpm link：
- 它会覆盖 pnpm 原生 symlink，导致路径指向错误位置（比如指向全局 node_modules）
- link 后的包不会被
references正确识别，TS Server 无法建立跨包依赖图 - 一旦用了 link，必须手动删掉
node_modules/my-utils并重新pnpm install才能恢复
所有跨包引用都应通过 workspace 原生机制 + references + paths 三者配合，少一个环节跳转就断。
