npm install执行失败报错：未从命令行或npm配置中设置Python

该报错并非当前项目业务代码依赖Python导致，而是项目依赖树中某个第三方包需要编译C/C++原生扩展，npm生态中负责原生扩展编译的工具node-gyp强依赖Python环境，因此触发该报错。

Windows环境 #

• 方案一（推荐）：以管理员身份启动终端（PowerShell/CMD），执行命令 npm install --global --production windows-build-tools，该工具会自动安装适配的Python版本和Visual Studio构建组件，安装完成后重启终端即可重新执行依赖安装。
• 方案二（手动安装）：手动下载安装Python 3.7+版本，安装过程中勾选「Add Python to system PATH」选项，安装完成后执行命令 npm config set python python3 完成npm全局配置即可。

macOS环境 #

• 首先执行命令 xcode-select --install 安装Xcode命令行工具
• 通过Homebrew安装Python3：brew install python3
• 执行npm配置命令：Intel芯片设备执行 npm config set python /usr/local/bin/python3，M系列芯片设备执行 npm config set python /opt/homebrew/bin/python3

Linux环境（Debian/Ubuntu发行版为例） #

• 先安装基础构建依赖：sudo apt update && sudo apt install build-essential python3 -y
• 执行npm配置命令：npm config set python /usr/bin/python3

配置完成后先执行 npm config get python，确认返回的Python路径正常无报错，再删除项目目录下的node_modules文件夹、package-lock.json或yarn.lock文件，重新执行 npm install 即可完成依赖安装。

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