pnpm工作区node_modules链接指向异常原因及配置疑问

核心原因：workspace:*与link-workspace-packages是互补关系而非替代 #

你在依赖版本中使用workspace:*，只是声明依赖的版本来源为本地工作区，告诉pnpm“这个依赖从本地拿，不要去npm仓库找”，但它不控制pnpm最终链接本地包的具体路径。而link-workspace-packages=true是强制pnpm将本地包链接到其根目录，而非自动优化到dist输出目录，两者职责完全不同。

为什么会出现链接到dist的情况？ #

pnpm默认有个优化逻辑：如果本地包已完成构建，且package.json里的main/module等入口字段指向dist，pnpm会自动把链接指向dist，减少不必要的文件扫描。但这个优化和webpack的构建逻辑冲突：

• webpack的模块解析会深入依赖的文件系统路径，比如可能需要读取包根目录下的tsconfig.json、webpack配置片段，或是解析源码里的相对路径；如果链接指向dist，这些根目录文件会被排除在解析范围外，直接导致构建失败。
• rollup则更依赖package.json声明的入口字段，对依赖的实际文件路径敏感度低，因此不会触发这个问题。

prefer-workspace-packages=true的辅助作用 #

这个配置主要是确保当存在同名的外部npm包和本地工作区包时，优先用本地版本。它不是解决问题的核心，但和link-workspace-packages配合后，能强化本地包的优先级，避免pnpm在边缘场景（比如缓存的外部包干扰）下偏离工作区依赖。

总结 #

workspace:*解决的是“依赖从哪来”的问题，link-workspace-packages=true解决的是“依赖链接到哪”的问题。你的场景中，pnpm的自动链接优化和webpack的解析逻辑冲突，后者需要访问包根目录的文件，因此必须强制链接到根目录——这就是添加这两个配置能解决问题的原因。

内容的提问来源于stack exchange，提问作者Novaterata