npm 9.6.4执行所有命令均触发gyp错误的技术求助

• 清理npm缓存与依赖文件
  由于npm ls core显示包为空，大概率是依赖树或缓存异常导致的。执行以下命令重置依赖环境：

  npm cache clean --force
  rm -rf node_modules package-lock.json  # Windows系统替换为：rd /s /q node_modules && del package-lock.json
  npm install
  

• 降级Node.js至LTS版本
  Node.js v19为非长期支持版本，core@1.0.113的native模块（compress-buffer）可能未适配该版本的Node-API，从而触发Handle类型未定义的编译错误。建议切换到v18.x LTS版本（如v18.16.0），用nvm快速切换：

  nvm install 18.16.0
  nvm use 18.16.0
  

• 强制升级core包至兼容版本
  先查看core包的最新可用版本，替换为适配Node.js v19的版本：

  npm view core versions
  npm install core@latest
  

  如果是项目依赖的第三方包间接引入core@1.0.113，可在package.json中添加overrides字段强制替换版本：

  "overrides": {
    "core": "^2.0.0"  # 替换为实际兼容的版本号
  }
  

• 修复node-gyp编译环境
  尽管npm doctor显示正常，但编译环境可能存在隐性问题：

  • 全局重装node-gyp：npm install -g node-gyp
  • Windows用户：确保安装Visual Studio Build Tools，并配置npm指向对应版本：npm config set msvs_version 2022
  • Mac用户：安装Xcode命令行工具：xcode-select --install

• 清理编译缓存文件
  删除项目中残留的编译缓存，避免旧文件干扰：

  rm -rf node_modules/.cache  # 部分项目会生成.build目录，也可一并删除
  

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