我完全懂这种崩溃的感觉——全新系统本来应该顺顺利利，结果卡在node-gyp这种配置上真的太闹心了。结合你已经试过的操作，给你几个针对性的排查和解决方向：

1. 彻底清理node-gyp残留，重新安装依赖 #

有时候全局安装的node-gyp会和npm自带的版本冲突，导致路径识别异常，按以下步骤操作：

• 全局卸载node-gyp：

  npm uninstall -g node-gyp
  

• 手动删除npm自带的node-gyp文件夹：找到C:\Program Files\nodejs\node_modules\npm\node_modules\node-gyp，直接删除整个目录
• 强制清理npm缓存：

  npm cache clean --force
  

• 以管理员身份重新安装windows-build-tools（这个过程会自动安装Python 2.7和MSBuild工具，一定要等待完整完成，不要中途关闭命令行）：

  npm install --global --production windows-build-tools
  

2. 手动指定Python版本与MSBuild路径 #

node-gyp对Python版本有严格要求（必须是2.7，3.x版本不兼容），同时系统可能无法自动识别MSBuild位置：

• 检查Python 2.7是否安装成功：

  python --version
  

  如果显示不是2.7，手动下载安装Python 2.7，并将其路径添加到系统PATH环境变量中
• 配置npm使用Python 2.7：

  npm config set python python2.7
  

• 手动指定MSBuild路径（以VS2017 Build Tools为例，根据你实际安装的版本调整路径）：

  npm config set msbuild_path "C:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools\MSBuild\15.0\Bin\MSBuild.exe"
  

3. 检查环境变量与运行权限 #

• 确认系统PATH环境变量中包含以下路径：Python 2.7的安装目录、MSBuild的Bin目录、Node.js的安装目录
• 所有npm相关命令必须以管理员身份运行，普通用户权限可能导致文件访问失败或依赖安装不完整

4. 用nvm管理Node.js版本，避免版本兼容问题 #

部分新Node.js版本可能和node-gyp存在兼容性问题，尝试切换到稳定LTS版本：

• 彻底卸载当前Node.js，删除C:\Program Files\nodejs目录，以及%appdata%\npm和%appdata%\npm-cache文件夹
• 安装nvm（Node版本管理器），然后安装并切换到LTS版本：

  nvm install lts/*
  nvm use lts/*
  

• 重新执行windows-build-tools和node-gyp的安装步骤

5. 针对ursaNative编译警告的特殊处理 #

你遇到的ursaNative.cc编译警告+msbuild失败，可能是该包与新编译器版本不兼容：

• 安装该依赖时指定MSVS版本，强制使用旧版工具链：

  npm install ursa --msvs_version=2015
  

  （如果是其他依赖包，将ursa替换为对应的包名即可）
• 查看该包的仓库或npm页面，确认是否有最新版本修复了编译问题，尝试安装最新版

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