必须在vscode中打开含pnpm-workspace.yaml的根目录而非子包；确保各子包package.json含有效types字段并已构建；根tsconfig配置paths并让子包继承；调试需正确设置sourcemap和launch.json的outfiles。
VSCode 能直接支持 pnpm 工作空间，但默认不自动识别 pnpm-workspace.yaml，必须手动告诉它哪个文件夹是 workspace 根 —— 否则符号跳转、类型提示、依赖解析全会错乱。
怎么让 VSCode 正确识别 pnpm monorepo 根目录
VSCode 默认按打开的文件夹判断项目根，而 pnpm 工作空间里你很可能打开的是子包（比如 packages/ui），这时 TS 服务和 JS/TS 语言功能会只扫描该子包，导致跨包导入报错、import 提示找不到模块。
- 必须在 VSCode 中打开整个 workspace 根目录（即含
pnpm-workspace.yaml和pnpm-lock.yaml的那个文件夹），而不是某个packages/xxx - 如果习惯用命令行进子包再
code .，立刻退出，回到根目录再开：比如code /path/to/monorepo - 检查状态栏右下角：应该显示 “TypeScript SDK: Workspace version”；如果显示 “Project version” 或路径指向子包里的
node_modules/.pnpm/...，说明识别错了
为什么 TypeScript 仍报“无法找到模块”，即使已打开根目录
pnpm 的硬链接结构会让 TypeScript 语言服务器读不到符号链接后的类型定义，尤其当子包没显式声明 types 字段或 package.json 缺少 "types": "dist/index.d.ts" 时。
- 确保每个子包的
package.json包含有效的types字段，且对应文件存在（如"types": "lib/index.d.ts"） - 在 workspace 根目录下运行
pnpm build（或你约定的构建命令），让所有子包生成lib/或dist/类型文件 - VSCode 可能缓存旧的 TS 语言服务状态：按
Ctrl+Shift+P（macOSCmd+Shift+P）→ 输入 “TypeScript: Restart TS server” 手动重启 - 不要依赖
node_modules里的软链接类型 —— pnpm 不放类型文件进去，只留硬链接，TS 读不到
如何让 VSCode 的 import 自动补全跨包路径
默认情况下，VSCode 的 import 补全只查当前包和 node_modules，不会扫描 workspace 内其他包，除非你明确配置了路径映射。
- 在 workspace 根目录的
tsconfig.base.json（或根级tsconfig.json）中配compilerOptions.paths：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@myorg/*": ["packages/*/src/*"],
"@myorg/ui": ["packages/ui/src/index.ts"],
"@myorg/utils": ["packages/utils/src/index.ts"]
}
}
}
- 所有子包的
tsconfig.json需extends这个基配置，否则路径别名不生效 - VSCode 不会自动 reload
paths修改：改完后必须重启 TS server（见上一条） - 注意：路径别名只影响类型检查和补全，运行时仍靠 pnpm 的 link 机制，所以别忘了
pnpm build或pnpm dev启动本地 watch
调试时断点进不去子包源码？检查 source map 和工作区设置
pnpm monorepo 下调试失败，90% 是因为 source map 没正确映射到原始 src/，或者 VSCode 的 launch.json 没设对 outFiles。
- 子包构建工具（如 tsup、vite、rollup）必须开启
sourceMap: true，且输出路径与outFiles匹配 - 在根目录的
.vscode/launch.json中，outFiles应覆盖所有子包构建产物，例如：
"outFiles": [
"${workspaceFolder}/packages/**/dist/**/*.js",
"${workspaceFolder}/packages/**/lib/**/*.js"
]
- 如果用
pnpm run dev启的服务，确保它启用 source map（如 vite 默认开，ts-node 需加--project tsconfig.json --files） - 别在子包里单独建
.vscode/launch.json—— 它会覆盖根配置，导致路径解析错乱
真正麻烦的不是配置本身，而是这些设置分散在 tsconfig.json、构建配置、VSCode launch 文件、甚至 pnpm hooks 里，漏掉任意一环，就会出现“代码改了但断点不进”“类型有但 import 报红”这类静默失效问题。
