Windows10系统npm安装windows-build-tools卡住及报错问题求助

出现该问题是因为windows-build-tools包长期未更新，内置的安装校验逻辑和新版Windows 10、Visual Studio Installer的状态回调不兼容，导致要么安装卡住，要么明明安装成功却返回错误，属于包本身的已知缺陷。

第一步：清理现有安装残留 #

• 打开任务管理器，终止所有npm、node、vs_BuildTools.exe相关进程
• 删除本地缓存目录：C:\Users\winuser\.windows-build-tools
• 执行npm缓存清理命令：npm cache clean --force
• 进入控制面板-程序和功能，卸载所有名称包含Visual Studio Build Tools、Visual C++ Build Tools的程序，完成后重启电脑

第二步：手动安装依赖（推荐方案，兼容性最好） #

该方案绕开停止维护的windows-build-tools包，直接安装所需依赖，稳定性最高：

1. 下载Visual Studio Build Tools 2017安装包，运行后勾选使用C++的桌面开发 workload，右侧可选组件需勾选「Windows 10 SDK」、「MSVC v140 生成工具」，等待安装完成后重启电脑
2. 你的设备已安装Python 2.7.18，无需重复安装；如果后续运行提示找不到Python，手动将Python 2.7的安装目录添加到系统环境变量PATH中

第三步：配置npm全局编译参数 #

打开管理员权限的CMD/PowerShell，依次执行以下命令：

npm config set msvs_version 2017 --global
npm config set python python2.7 --global

执行完成后可运行npm config list确认配置已生效，后续即可正常安装需要编译的npm包。

替代方案：修复windows-build-tools包安装问题 #

如果需要继续使用npm包安装的方式，可以执行带指定参数的安装命令：

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

如果执行过程中出现卡住、或者提示Could not install Visual Studio Build Tools错误，直接手动终止进程即可。从你提供的日志判断Visual Studio Build Tools已经实际安装成功，只需要执行上一步的npm配置命令即可正常使用。

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