解决electron-builder在pnpm hoisted模式下找不到模块的问题

问题背景

在使用electron-builder构建Electron应用时，部分开发者遇到了"Error: Cannot find module '.../package.json'"的错误。这个问题主要出现在使用pnpm包管理器并启用了hoisted模式(node-linker=hoisted)的项目中。

问题分析

该问题的核心在于electron-builder在解析依赖路径时的处理逻辑。当启用pnpm的hoisted模式时，依赖会被提升到node_modules根目录下，而electron-builder默认的路径解析逻辑会尝试在.pnpm目录下查找模块，导致路径拼接错误。

具体表现为：

1. electron-builder会尝试访问类似"node_modules/.pnpm/dayjs@1.11.13/node_modules/dayjs/package.json"的路径
2. 但实际上在hoisted模式下，dayjs应该位于"node_modules/dayjs/package.json"
3. 这种路径解析错误导致构建失败

解决方案

临时解决方案

对于急需解决问题的开发者，可以采取以下临时方案：

1. 移除.npmrc中的node-linker=hoisted配置
2. 或者为特定依赖设置例外规则，如：

node-linker=hoisted
hoist-pattern[]=!eslint*

根本解决方案

electron-builder团队正在开发更完善的解决方案，计划通过以下方式彻底解决问题：

1. 自动检测项目的.npmrc配置
2. 根据node-linker设置智能选择对应的依赖解析策略
3. 同时支持hoisted和非hoisted两种模式

技术细节

在pnpm的hoisted模式下，依赖树结构会发生变化：

• 非hoisted模式：依赖严格按.pnpm目录结构组织
• hoisted模式：部分依赖被提升到node_modules根目录

electron-builder需要适应这两种不同的依赖组织结构，关键在于：

1. 正确识别当前项目的依赖管理模式
2. 动态调整模块查找路径算法
3. 保持与各种工具链(如eslint)的兼容性

最佳实践建议

在等待官方完整解决方案的同时，建议开发者：

1. 评估项目是否真正需要hoisted模式
2. 如果必须使用hoisted模式，优先考虑为electron-builder相关依赖设置例外
3. 关注electron-builder的版本更新，及时升级到包含完整修复的版本

总结

electron-builder与pnpm hoisted模式的兼容性问题是一个典型的工具链集成挑战。通过理解依赖管理的底层机制，开发者可以更好地诊断和解决这类构建问题。electron-builder团队正在积极改进这一问题的解决方案，未来版本将提供更智能的依赖解析能力。