本地环境NPM安装失败，执行windows-build-tools命令卡住16小时未响应

根因说明 #

本次报错是npm安装包含原生构建逻辑的依赖时，Python环境路径未正确配置导致。安装windows-build-tools长时间无响应是因为该包已停止维护，仅适配Node.js v10及更早版本，拉取过时的Python 2.7、VS构建工具依赖时极易出现阻塞问题，不适配你当前使用的Node.js v16版本。

分步操作步骤 #

• 终止当前卡住的命令行进程，先卸载已安装的异常版本windows-build-tools：
  npm uninstall --global windows-build-tools
• 配置符合版本要求的构建环境
  方案一（推荐，无需手动配置）：重新运行Node.js v16.13.0的官方安装包，在安装引导界面勾选 Automatically install the necessary tools 选项，安装向导会自动完成Python、VS构建工具的安装和npm环境变量配置，全程无需手动调整。
  方案二（本地已安装Python 3.7+可用）：直接执行命令指定npm调用的Python路径即可：
  npm config set python "你的Python可执行文件完整绝对路径"
• 清理npm无效缓存：
  旧版npm cache clean命令已废弃，需执行以下命令完成缓存清理：
  npm cache clean --force
• 重新安装项目依赖：
  回到项目根目录，确认已删除node_modules目录、package-lock.json文件后，执行安装命令：
  npm install

场景截图参考 #

依赖安装错误截图 #

构建工具安装卡住截图 #

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