安装Start Bootstrap简历模板依赖失败，报错Build failed with error code:1

问题原因 #

报错的核心是node-sass依赖的node-gyp构建工具无法找到名为python的可执行文件——你安装的Python 3.x在系统中默认以python3的命令存在，而旧版本的node-gyp只会查找python或python2命令。

解决方案 #

方法1：临时指定Python路径执行安装 #

在终端执行安装命令时，直接指定PYTHON环境变量指向你的Python3：

PYTHON=$(which python3) npm install

方法2：给Python3创建python别名（永久生效） #

在你的shell配置文件（如~/.zshrc或~/.bashrc，取决于你用的终端shell）中添加一行别名配置：

alias python='python3'

保存文件后，执行以下命令让配置生效：

source ~/.zshrc
# 如果你用bash，就执行 source ~/.bashrc

之后重新打开终端，再运行npm install即可。

方法3：全局配置npm的Python路径 #

通过npm的全局配置指定默认使用的Python版本，一次配置永久生效：

npm config set python $(which python3)

配置完成后直接运行npm install即可。

补充说明 #

这个模板的依赖版本偏旧（Bootstrap 4 beta 2、Gulp 3.9.x），对应的node-sass版本也比较老，因此对Python的识别逻辑还停留在旧版本。优先通过上述方法解决Python路径问题，尽量避免随意升级依赖，否则可能引发其他兼容问题。

内容的提问来源于stack exchange，提问作者Peter Farrow