Node.js 安装 windows-build-tools 报错解决与完整教程

作者:岩茶

时间:2026-10-25

浏览:178

本文详细记录在Windows环境下通过npm安装windows-build-tools时遇到的常见报错及解决方案。涵盖Node.js、npm及Python 2.7的环境配置,重点解决安装脚本因日志文件命名差异导致的卡死问题,提供通过修改临时目录日志文件绕过检查的具体步骤。

文章目录

在使用 `npm install --global --production windows-build-tools` 命令时,用户经常遇到各种难以排查的报错。本文整理了一套经过验证的安装流程,旨在帮助用户顺利完成构建工具的安装。

本文安装环境

  • node 16.8
  • npm 7.18
  • python 2.7.15

Node.js和npm的基础配置在此不再赘述,重点在于后续依赖环境的配置。

python安装

Python的下载地址为 https://www.python.org/ftp/python/2.7.15/python-2.7.15.amd64.msi,请根据系统架构选择对应版本下载。

环境变量

  • C:\Python27
  • C:\Python27\Scripts

验证环境变量

  • node -v
  • npm -v
  • python -V

uuid@3.4.0: Please upgrade to version 7 or higher.

npm install uuid@latest -g

在安装过程中,用户可能会遇到安装进程卡住的情况。社区中有开发者针对此问题提供了相关的解决方案。

Stuck at python installed successfully · Issue #244 · felixrieseberg/windows-build-tools · GitHub

本文安装环境

“Windows-build-tools脚本存在问题,无法找到VS构建工具安装程序的日志文件。

似乎VS构建工具安装程序创建的日志文件已更改。

该脚本正在文件夹%USERPROFILE% AppData Local Temp中寻找名称以dd_client_开头的日志文件,但是VS构建工具安装程序似乎并未创建任何以dd_client_开头的文件。”

解决步骤:

1、运行npm install -g windows-build-tools

2、在%temp%文件夹中找到最新的文件名类似于dd_installer_20210421124746.log的文件

3、查看此文件,确保日志中输出了Closing the installer with exit code 0

4、确保你安装了vscode

ps:其实可以直接跳过2–4步,因为你的python环境早就安装好了,重复的步骤安装程序早就执行完毕了

5、在%temp%目录下创建一个名为dd_client_.log的文件

6、编辑5中创建的文件,加入一行Closing installer. Return code: 3010.然后保存。

然后windows-build-tools就可以继续安装了

注:直接在资源管理器中粘贴%temp%即可打开你的Windows temp目录。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持本站。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章