GitHub Actions部署报错：node-sass安装失败，根源是Node和Python版本冲突
在利用GitHub Actions自动构建并部署Vue项目到GitHub Pages时，很多开发者会遇到node-sass安装失败的报错，错误码通常为1，且日志中反复出现node-gyp调用Python失败的信息。本文从实际报错日志入手，分析根因并给出两种可行的修复方案。npm ERR! code 1
npm ERR! path /home/runner/work/CvReport/CvReport/node_modules/node-sass
npm ERR! command failed
npm ERR! command sh -c -- node scripts/build.js
npm ERR! Building: /usr/local/bin/node /home/runner/work/CvReport/CvReport/node_modules/node-gyp/bin/node-gyp.js rebuild --verbose --libsass_ext= --libsass_cflags= --libsass_ldflags= --libsass_library=
...
npm ERR! gyp ERR! stack SyntaxError: Missing parentheses in call to 'print'. Did you mean print(...)?
...
报错日志中关键线索有两个：
- 错误出现在node-gyp尝试执行 `/usr/bin/python -c import sys; print "%s.%s.%s" % sys.version_info[:3];` 时，Python3抛出了SyntaxError，因为`print`在Python3中必须作为函数调用，而旧版node-gyp（3.8.0）生成的命令是Python2语法。
- 实际环境中检测到的是 `/usr/bin/python`（Python3），而node-gyp需要Python2。
更深层的原因：GitHub Actions的默认Ubuntu镜像中，`python`通常指向Python3，而node-sass依赖的node-gyp版本较老，编译时要求Python2。但直接根源是Node.js版本过高——当通过`actions/setup-node@v3`不指定版本时，会使用最新Node（如v16.18.1），而该Node版本对应的node-gyp版本（3.8.0）已不再适配Python3。本地开发使用Node v14.18.3可以正常安装，说明低版本Node搭配node-gyp版本兼容性更好。
解决方案分为两步：
1. 在GitHub Actions工作流中明确指定Node.js版本，避免使用最新版。
2. 可同时指定多个版本进行矩阵测试，确保至少一个版本能成功构建。
这是修正后的workflow示例（单版本）：
name: Node.js CI
on:
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Use Node.js
uses: actions/setup-node@v3
with:
node-version: '12.x'
- run: npm ci
- run: npm run build --if-present
- run: npm test
如果需要测试多个版本，可以使用矩阵策略：
name: Node.js CI
on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
jobs:
build:
runs-on: ubuntu-latest
strategy:
matrix:
node-version:
steps:
- uses: actions/checkout@v3
- name: Use Node.js ${{ matrix.node-version }}
uses: actions/setup-node@v3
with:
node-version: ${{ matrix.node-version }}
- run: npm ci
- run: npm run build --if-present
- run: npm test
实际测试结果：Node 14.x版本成功构建，而Node 15.x失败。因此推荐使用与本地开发环境一致的Node版本（如14.x或12.x），避免使用v15及以上版本，直到相关依赖更新兼容。
另外，如果必须使用新版Node，还可以考虑切换到`dart-sass`替代`node-sass`，但这需要修改项目中的sass依赖配置，不在本文讨论范围。
总结：在GitHub Actions中自动化安装node-sass失败，通常是因为Actions默认使用了最新Node版本，导致node-gyp无法找到Python2或与Python3不兼容。通过显式设置`node-version`为稳定版本（如12.x、14.x），即可规避该问题。该思路同样适用于其他CI/CD环境（如Jenkins、GitLab CI），只要在构建前确保Node版本与本地开发一致即可。
Re: GitHub Actions部署报错：node-sass安装失败，根源是Node和Python版本冲突
感谢楼主分享这么详细的分析！最近我也在GitHub Actions里碰到过类似的node-sass报错，当时卡了好一阵子，只记得降Node版本能解决，但没深究到node-gyp和Python的兼容性层面。你从日志中`print`语法错误入手，把Python2/3冲突和Node版本连带影响串起来讲得很清楚，特别是提到node-gyp 3.8.0不再适配Python3这个关键点，让我对问题根因的理解又深了一层。矩阵测试的策略也很实用，既能验证哪个版本稳定，又不影响其他分支的构建。我之前只用单一版本，下次可以试试矩阵配置来提前发现问题。另外你提到的dart-sass替代方案虽然没展开，但也是个值得考虑的方向。总之非常感谢这篇实战排查经验，收藏了！Re: GitHub Actions部署报错：node-sass安装失败，根源是Node和Python版本冲突
感谢分享，分析得很透彻！最近我也在 CI 里被 node-sass 坑过，查了半天才发现是 node-gyp 和 Python 版本不兼容。你列出的错误日志跟我当时看到的一模一样，尤其是那个 `print` 语法错误，特别经典。 手动指定 Node 版本确实是最直接有效的办法，矩阵测试也能提前把坑踩一遍。另外不知道你有没有试过把 `node-sass` 换成 `sass`（dart-sass）？如果项目允许的话，新版 Node 下完全没这些问题，安装也快不少。当然迁移可能要看具体项目约束。 总之你这篇总结很实用，收藏了！Re: GitHub Actions部署报错：node-sass安装失败，根源是Node和Python版本冲突
感谢楼主的详细分析！这个问题确实很常见，尤其是项目还在用 `node-sass` 的时候。你从日志中定位到 `print` 语法错误和 Python 版本冲突，然后追溯到 Node 版本过高导致 node-gyp 版本不兼容，思路非常清晰。 我补充一点：如果项目允许的话，迁移到 `sass`（dart-sass）其实更省心，GitHub Actions 默认环境就能直接跑，而且性能也更好。当然有些旧项目改起来麻烦，你给出的指定 Node 版本方案是成本最低的修复方式。 另外，设置 Node 版本时建议和 `package.json` 里的 `engines` 字段保持一致，这样团队协作和 CI 环境都不容易出问题。感谢分享！
页:
[1]