VSCode怎么配置pnpm工作区（Monorepo）的代码跨包跳转-VSCode-PHP中文网

根本原因是TypeScript未正确解析pnpm的符号链接路径；需配置pnpm-workspace.yaml、根tsconfig.json启用references及paths映射，子包tsconfig设composite:true，VSCode须打开根工作区并重启TS Server。

vscode怎么配置pnpm工作区（monorepo）的代码跨包跳转

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 或源码，就会提示找不到定义。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

检查三处关键配置：

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：