树莓派2GB设备npm包安装冻结，卡在reify阶段求助

问题核心原因 #

树莓派2GB内存资源有限，electron包体积大且安装时需下载对应架构的二进制文件，加上NPM 9.x的reify机制在低内存设备易出现资源耗尽导致卡顿；另外用sudo执行npm命令会引发权限、缓存冲突，加剧安装异常。

具体解决步骤 #

1. 取消sudo执行npm install #

sudo会篡改npm缓存目录权限，引发安装冲突，直接用普通用户执行：

npm i

若遇权限报错，先修复缓存目录权限：

sudo chown -R $USER:$USER ~/.npm

2. 扩容swap分区缓解内存不足 #

2GB内存无法支撑electron安装，临时扩容swap：

# 停止当前swap服务
sudo dphys-swapfile swapoff
# 修改swap大小为2GB
sudo sed -i 's/CONF_SWAPSIZE=100/CONF_SWAPSIZE=2048/' /etc/dphys-swapfile
# 重启swap服务
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

安装完成后建议改回原swap大小，减少SD卡损耗。

3. 设置electron国内镜像加速下载 #

electron默认从境外服务器下载，速度慢易超时，通过配置镜像解决：

npm config set electron_mirror "https://npmmirror.com/mirrors/electron/"

或在项目根目录创建.npmrc文件，写入：

electron_mirror=https://npmmirror.com/mirrors/electron/

4. 降级NPM版本 #

NPM 9.x的reify机制在低资源设备兼容性较差，降级到稳定的8.x版本：

npm install -g npm@8.19.4

5. 清理缓存后重新安装 #

清除损坏的缓存文件，避免干扰安装：

npm cache clean --force
rm -rf node_modules
npm i

6. 单独安装electron再处理其他依赖 #

优先完成体积最大的electron安装，再安装其余依赖：

npm i electron@^22.1.0
npm i

结果验证 #

安装完成后检查是否生成package-lock.json，执行npm list确认所有依赖安装正常。

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