Windows下npm install -g -production windows-build-tools过慢怎么办

windows-build-tools这个npm包已经停止维护超过4年，Truffle旧版官方指南里的安装步骤已经完全不适配Win10 2004及之后发布的所有Windows版本，这是命令长时间卡住无响应的核心原因，和截图里卡在等待安装完成的表现完全匹配。

第一步：清理卡住的残留进程 #

• 在当前卡住的PowerShell窗口按Ctrl + C终止npm安装进程，如果按键无响应，直接打开任务管理器，结束所有node.exe、msiexec.exe名称的残留进程即可。
• 打开资源管理器进入C:\Users\你的当前用户名\目录，删除名为.windows-build-tools的隐藏文件夹，清空之前失败安装留下的缓存文件。

第二步：手动安装构建依赖（完全替代废弃的windows-build-tools包） #

不需要通过npm安装第三方构建工具包，直接安装官方组件就能满足Truffle及所有Node.js原生模块的编译需求：

1. 按下Win + R输入optionalfeatures回车，打开Windows功能面板，勾选.NET Framework 3.5、.NET Framework 4.8 高级服务两个选项，点击确定等待组件安装完成后重启电脑。
2. 安装Visual Studio 2022生成工具，安装时仅需勾选「使用C++的桌面开发」工作负载，同时确认右侧附带的「MSVC v143生成工具」、「Windows 10/11 SDK」两个组件处于勾选状态，等待安装完成。
3. 安装Python 3.10及以上版本，安装过程中必须勾选「Add Python to PATH」选项，安装完成后打开新的PowerShell窗口执行python --version，确认能正常输出版本号即代表安装成功。
4. 以管理员身份打开PowerShell，依次执行以下命令配置Node.js编译环境：

npm install -g node-gyp
npm config set msvs_version 2022
npm config set python python

第三步：安装Truffle #

完成以上配置后，关闭所有已打开的PowerShell窗口，重新打开普通权限的PowerShell，直接执行Truffle安装命令即可：

# 如果下载速度慢可以先执行 npm config set registry https://registry.npmmirror.com 切换国内源
npm install -g truffle

安装全程不会再出现长时间无响应的问题，所有原生依赖会自动调用你之前装好的系统构建组件完成编译。

额外排查点 #

• 如果安装过程中提示权限错误，不要全程用管理员权限运行PowerShell安装npm全局包，只需要给当前用户分配npm全局安装目录（默认路径C:\Users\你的用户名\AppData\Roaming\npm）的完全读写权限即可。
• 如果后续执行truffle version提示找不到构建工具，重启一次电脑让系统环境变量生效即可解决。

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