安装依赖sqlite3的全局包时遇node-gyp构建错误：v8::Object无ForceSet成员

你遇到的其实是Node.js版本升级后的Native模块兼容性问题——Node 10.x对V8引擎的API做了更新，移除了v8::Object::ForceSet这个方法，但很多依赖node-gyp编译的旧版包（比如早期的sqlite3）还在调用这个已被废弃的API，所以触发了构建失败。结合你的环境（OS Sierra 10.13.4 + Node 10.0.0），给你几个可行的解决方向：

1. 降级到Node.js LTS版本（最稳妥方案） #

Node 10.x在当年属于较新的大版本，很多Native模块的适配进度没跟上，而LTS版本（比如8.x系列）兼容性更完善，能直接避开这个API变更问题：

• 如果你用nvm管理Node版本，执行：

  nvm install 8.16.0
  nvm use 8.16.0
  

• 没有nvm的话，直接从Node官网下载8.x系列的安装包覆盖安装即可。

2. 升级node-gyp并修复编译环境 #

如果不想降级Node，尝试更新node-gyp到支持Node 10的版本，同时确保编译工具链正常：

• 全局更新node-gyp：

  npm install -g node-gyp@latest
  

• 确认Xcode命令行工具是最新状态（虽然你说Xcode没问题，但再检查一遍更稳妥）：

  xcode-select --install
  

• 对于依赖sqlite3的包，优先安装适配Node 10的最新版本：

  npm install -g sqlite3@latest
  

  如果是其他全局包出现同样错误，先查看该包是否有更新版本，优先安装最新版。

3. 带权限参数尝试安装 #

有时候系统权限限制会干扰node-gyp的编译流程，加上--unsafe-perm参数可以绕过部分权限问题：

npm install -g [你的目标包名] --unsafe-perm

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

缓存损坏也可能导致奇怪的编译错误，先清理npm缓存再重试：

npm cache clean --force
npm install -g [你的目标包名]

如果用Yarn的话，对应命令是：

yarn cache clean
yarn global add [你的目标包名]

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