使用pnpm link本地安装依赖时，Webpack构建输出不一致问题求助

我有一个Node项目，依赖某私有npm包。需要生成一份源码归档，让其他人能构建出和我完全一致的结果。由于无法提供私有仓库访问权限，我把该包的源码和项目打包在一起。但遇到以下问题：

• 构建该包后，用pnpm link <path to pkg dir>或pnpm install <path to pkg dir>安装，Webpack生成的输出和从私有仓库安装时不一致。
• 已确认该包自身的构建结果和私有仓库中的完全一致，问题出在项目端。
• 尝试从私有仓库下载包后用npm pack生成归档，再用pnpm install <path to pkg archive>安装，输出仍有差异。看起来不管包内容如何，安装方式的变化都会影响构建结果。

• 检查Webpack的依赖解析配置
  本地依赖（尤其是symlink方式）可能触发Webpack的不同解析逻辑。比如Webpack的resolve.symlinks默认是true，会解析symlink到实际路径，这可能导致模块的绝对路径变化，影响hash生成或模块匹配。可以尝试将resolve.symlinks设为false，强制Webpack将symlink视为普通目录解析。另外，检查resolve.mainFields、resolve.exports等配置，确保本地安装时Webpack选取的入口文件和私有仓库安装时一致（比如私有仓库的包可能只包含构建后的文件，而本地目录有源码，Webpack可能优先选了源码文件）。

• 对比依赖树与lock文件
  用pnpm list分别输出两种安装方式下的完整依赖树，检查子依赖版本是否有差异。同时对比pnpm-lock.yaml文件，看本地安装是否触发了子依赖的重新解析（比如私有仓库的包可能在打包时已经锁定了子依赖版本，而本地安装会根据项目的package.json重新计算）。如果有子依赖版本差异，需要将这些子依赖的版本在项目的package.json中固定，或者在本地包的package.json中添加pnpm-lock.yaml并一起打包，确保子依赖一致。

• 验证包的发布状态一致性
  确认私有仓库中的包是经过npm pack或pnpm pack打包后的产物，而不是直接上传源码。本地包需要和私有仓库的包结构完全一致：比如私有仓库的包可能只包含dist目录、package.json、README.md等，而本地目录可能还有src、node_modules、构建脚本等冗余文件。可以先在本地对包执行pnpm pack，然后将生成的tar包安装到项目中，再对比构建结果，确保本地打包后的包结构和私有仓库的一致。

• 排查Webpack的hash生成逻辑
  如果输出差异仅在于文件hash值不同，大概率是模块的绝对路径变化导致Webpack的contenthash或chunkhash计算变化。可以尝试在Webpack配置中添加hashSalt字段固定盐值，或者使用webpack-manifest-plugin生成稳定的manifest文件，避免路径影响hash。另外，检查是否有插件（如mini-css-extract-plugin）的hash配置，确保其计算逻辑不受文件路径影响。

• 清理缓存后重新构建
  清理项目的node_modules、dist目录，以及Webpack的缓存目录（通常在node_modules/.cache/webpack），然后分别用两种安装方式重新构建，排除缓存导致的差异。

• 模拟私有仓库安装的环境
  将本地打包后的tar包替换到项目node_modules中对应私有包的位置，直接执行构建，看结果是否和私有仓库安装一致。如果一致，说明问题出在pnpm的安装过程（比如硬链接、扁平化处理），可以尝试用pnpm install --shamefully-hoist或调整pnpm的配置，让本地安装的依赖结构和仓库安装一致。

内容的提问来源于stack exchange，提问作者Michal Vašíček