我之前在Azure Pipelines的Windows代理上升级Node.js到14后，也遭遇过node-gyp相关的安装错误，整理了几个亲测有效的解决方案，你可以逐一尝试：

1. 补全Windows环境下的构建依赖 #

node-gyp在Windows上必须依赖Visual Studio构建工具和Python环境，你可以在Yarn Install任务前新增一个PowerShell任务，运行命令一键安装所需组件：

npm install --global windows-build-tools@4.0.0

或者直接用Azure Pipelines自带的Visual Studio Build Tools安装任务，勾选「C++ build tools」以及对应版本的Windows SDK（Node.js 14推荐选Windows 10 SDK 1903及以上版本）。

2. 配置node-gyp的环境变量 #

在Yarn Install前添加一个环境变量配置步骤，明确指定Python路径和Visual Studio版本：

• 设置PYTHON变量指向Python 3.6+的安装路径（Node.js 14不再推荐Python 2.7）
• 设置GYP_MSVS_VERSION为你安装的Visual Studio版本号，比如2019

示例Azure Pipelines YAML配置：

- script: |
    set PYTHON=C:\Python39\python.exe
    set GYP_MSVS_VERSION=2019
  displayName: 'Configure node-gyp environment variables'

3. 清理缓存后强制重装 #

旧的依赖缓存很可能导致版本兼容冲突，你可以在Yarn Install前添加清理步骤：

yarn cache clean
rm -rf node_modules

之后执行yarn install --force强制重新拉取所有依赖包。

4. 升级node-gyp本身 #

直接全局安装最新版node-gyp，或者在项目内强制指定兼容版本：

npm install --global node-gyp@latest

也可以在项目的package.json中添加resolutions字段锁定node-gyp版本：

"resolutions": {
  "node-gyp": "^9.0.0"
}

再运行yarn install让配置生效。

5. 排查依赖包的Node.js兼容性 #

有些老旧的原生扩展包可能没适配Node.js 14，重点看报错信息里提到的具体包，去查它的文档或GitHub Issues，确认是否有兼容Node.js 14的版本，必要时升级该依赖包。

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