NPM相关命令之报错node-gyp…的解决方法

当我们在使用npm相关命令时，有时会遇到一些意外情况，比如在安装某个包时报错，其中的错误信息中可能会出现"node-gyp"相关的提示。这种情况下可以根据以下方法解决：

问题描述

报错信息如下所示：

gyp ERR! configure error                         
gyp ERR! stack Error: Can't find Python executable "python", you can set the PYTHON env variable.
gyp ERR! stack     at PythonFinder.failNoPython (.../node-gyp/lib/find-python.js:307:47)
gyp ERR! stack     at PythonFinder.<anonymous> (.../node-gyp/lib/find-python.js:489:16)

解决方法

1. 确认安装Python环境

node-gyp需要依赖Python环境才能正常工作，所以确认本地是否安装了Python环境是首要的步骤，可使用python -V命令确认是否已安装。如果未安装，请安装最新版Python环境，并配置环境变量。

1. 配置环境变量

如果已确认已经安装Python环境，那么请确保环境变量中的PYTHON环境变量已经正确配置。在Windows系统中，可以通过"控制面板->系统和安全->系统->高级系统设置->环境变量"来为当前用户或系统配置环境变量，添加或修改环境变量的值。

需要将PYTHON的值设置为Python的可执行文件所在的路径。例如，在Windows系统中，默认安装Python的路径为C:\Python27，那么环境变量PYTHON的值应该设置为C:\Python27\python.exe。

在Mac或Linux系统中，则可通过在终端中执行下面的命令来修改环境变量：

sh
export PYTHON=/usr/local/bin/python

注：Python环境变量配置完成后，请先关闭控制台或终端，并重新启动该控制台或终端，以便让修改的环境变量生效。

示例说明

下面通过两个示例说明如何解决"node-gyp"相关报错的问题。

示例一

在安装node-canvas包时，提示缺少python环境：

gyp ERR! node-gyp -v v3.8.0
gyp ERR! not ok 
node-pre-gyp ERR! build error 
node-pre-gyp ERR! stack Error: Failed to execute 'node-gyp build --fallback-to-build 
--library=static_library --module=C:\Users\Administrator\Desktop\demo\node_modules\node-canvas\build\Release\canvas.node 
--module_name=canvas --module_path=C:\Users\Administrator\Desktop\demo\node_modules\node-canvas\build\Release' (1)
node-pre-gyp ERR! stack     at ChildProcess.<anonymous> 
(C:\Users\Administrator\Desktop\demo\node_modules\node-pre-gyp\lib\util\compile.js:83:29)
...
gyp ERR! configure error 
gyp ERR! stack Error: Can't find Python executable "python", 
you can set the PYTHON env variable.
gyp ERR! stack     at PythonFinder.failNoPython (.../node-gyp/lib/find-python.js:307:47)
...

问题解决步骤：

1. 检查是否已安装Python环境：在终端执行python -V命令，如果未安装则安装Python环境；
2. 确认环境变量是否设置：在终端执行echo $PYTHON命令，如果未设置则在~/.bashrc或~/.bash_profile文件中添加export PYTHON=python语句，然后重新打开终端；

示例二

在安装bcrypt包时，提示缺少node-gyp模块：

gyp ERR! stack Error: Can't find Python executable "python", 
you can set the PYTHON env variable.
gyp ERR! stack     at PythonFinder.failNoPython (.../node-gyp/lib/find-python.js:307:47)
gyp ERR! stack     at PythonFinder.<anonymous> (.../node-gyp/lib/find-python.js:489:16)
...

问题解决步骤：

1. 确认是否已安装node-gyp模块：在终端执行npm ls -g node-gyp命令，如果未安装则执行npm install -g node-gyp命令安装；

2. 配置环境变量：在终端执行export PYTHON=python命令，如果提示权限问题则切换至root用户再执行。

通过以上两个示例说明，相信你已经完全明白如何解决"NPM相关命令之报错node-gyp...的解决方法"了。