Mac环境Node项目执行npm install时bcrypt安装失败报错

报错核心触发点为bcrypt包原生C++扩展编译环节出错：bcrypt安装时会优先拉取对应平台的预编译二进制包，拉取失败就会回退到本地源码编译，本地编译环境缺失、版本不兼容、网络异常都会触发这类报错。

按优先级从高到低尝试以下方案：

• 替换为无编译依赖的兼容包（成本最低，优先选）
  bcryptjs与原生bcryptAPI完全一致，无原生编译环节，不受本地环境影响，不会反复出现安装问题。操作步骤：
  1. 执行npm uninstall bcrypt卸载原有bcrypt依赖
  2. 执行npm install bcryptjs安装替代包
  3. 将项目中所有require('bcrypt')/import bcrypt from 'bcrypt'的引入语句替换为require('bcryptjs')/import bcrypt from 'bcryptjs'，其余业务代码无需改动。
• 补全本地编译环境（必须使用原生bcrypt时选择）
  不同操作系统补全编译依赖的操作如下：
  • Mac系统：执行xcode-select --install安装Xcode命令行编译工具，安装完成后删除项目下的node_modules文件夹与package-lock.json文件，重新执行npm install
  • Windows系统：以管理员身份启动命令行，执行npm install --global windows-build-tools安装C++编译套件，安装完成后重启命令行再重新安装依赖
  • Debian/Ubuntu系Linux系统：执行sudo apt update && sudo apt install build-essential python3安装基础编译依赖，再重试安装
• 修复网络源问题
  若因网络问题拉取不到预编译包触发本地编译，先执行npm config set registry https://registry.npmmirror.com切换国内npm镜像，删除node_modules与package-lock.json后重新执行npm install。
• 版本兼容排查
  以上方案无效时，检查本地Node.js版本与项目锁定的bcrypt版本适配关系：bcrypt对Node版本有明确适配要求，版本不匹配会直接导致编译失败，可升降Node版本到对应兼容区间，或执行npm install bcrypt@latest安装适配当前Node版本的最新bcrypt版本。

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