pnpm项目中onlyBuiltDependencies配置失效问题解析

问题背景

在pnpm包管理工具的最新版本10.0.0-rc.1中，用户发现了一个关于构建依赖配置的重要问题。pnpm.onlyBuiltDependencies配置项在实际使用中完全失效，无法按照预期工作。这个问题在Linux系统（Arch发行版）上使用Node.js v23.5.0环境下被确认存在。

问题表现

当用户在项目中配置pnpm.onlyBuiltDependencies来指定需要运行构建脚本的特定依赖包时，pnpm会完全忽略这个配置项。这意味着即使明确列出了需要构建的依赖项，pnpm也不会执行这些依赖项的构建脚本。

有趣的是，虽然pnpm.onlyBuiltDependencies配置失效，但功能类似的pnpm.onlyBuiltDependenciesFile配置却能正常工作。此外，文档中pnpm.neverBuiltDependences配置的描述与pnpm.onlyBuiltDependencies几乎相同，都使用了"跳过构建的依赖项列表"这样的表述，这可能会造成用户混淆。

技术分析

经过项目核心成员的检查，确认这个问题是在一个重要的代码合并过程中引入的。具体来说，是在处理构建依赖相关功能的代码重构时，错误地只实现了pnpm.onlyBuiltDependenciesFile的功能，而忽略了pnpm.onlyBuiltDependencies的实现。

影响范围

这个问题影响了所有使用pnpm 10.0.0-rc.1版本并尝试通过pnpm.onlyBuiltDependencies配置来控制依赖构建行为的用户。特别是对于那些依赖特定构建步骤才能正常工作的包，这个问题可能导致项目无法正确构建或运行。

解决方案

项目团队已经确认了问题的根源，并计划在当天发布修复版本。对于遇到此问题的用户，可以采取以下临时解决方案：

1. 暂时降级到pnpm的稳定版本
2. 使用pnpm.onlyBuiltDependenciesFile替代方案
3. 等待修复版本发布后立即升级

最佳实践建议

为了避免类似问题，建议开发者在升级到预发布版本时：

1. 充分测试所有关键功能
2. 关注项目的变更日志和已知问题
3. 在非关键项目中先进行试用
4. 准备好回滚方案

对于依赖构建控制的项目配置，目前推荐使用pnpm.onlyBuiltDependenciesFile作为更可靠的替代方案，直到问题完全修复。