Yarn构建失败返回错误码1，依赖安装无法完成怎么解决

问题根因 #

• 核心错误由node-sass依赖的node-gyp@3.8.0触发：该版本node-gyp仅支持Python 2.x，你本地环境仅安装了Python 3.9，执行Python2语法的检测代码时直接抛出语法错误
• 附加警告为包管理器混用导致：项目同时存在npm生成的package-lock.json和yarn的锁文件，可能引发依赖版本不一致问题
• 注：日志中的fsevents不兼容提示是正常现象，该依赖为macOS系统专属可选依赖，Windows环境下会自动跳过，不影响项目运行

解决方案 #

推荐方案（一劳永逸） #

node-sass官方已停止维护，直接替换为兼容性更好的sass（dart-sass）即可，无需调整本地Python环境：

1. 清理现有依赖缓存和冲突锁文件

# 删除已安装的依赖目录
rm -rf node_modules
# 删除npm生成的锁文件，避免包管理器混用冲突
rm package-lock.json
# 可选删除yarn.lock以完全刷新依赖版本
rm yarn.lock

2. 替换sass依赖

yarn remove node-sass
yarn add sass -D

3. 重新安装全部依赖

yarn install

兼容方案（仅适用于必须保留当前node-sass版本的场景） #

如果项目不能替换node-sass，可按以下步骤配置兼容环境：

1. 安装Python 2.7版本，安装过程中务必勾选「Add Python to PATH」选项
2. 配置包管理器的Python路径指向安装的Python2.7

# 替换为你本地Python2.7的实际安装路径
yarn config set python C:\Python27\python.exe

3. 清理缓存后重新安装依赖

yarn cache clean
rm -rf node_modules
yarn install

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