执行yarn安装依赖时node-sass编译失败问题求助

一、解决node-sass安装失败（找不到python2） #

报错核心是node-sass 4.x版本依赖Python2，且与你当前使用的Node.js 18.x不兼容，以下是按推荐度排序的解决方案：

1. 替换为dart-sass（推荐） #

node-sass已停止维护，dart-sass是官方推荐替代方案，无需Python环境，兼容性更好：

# 移除旧的node-sass
yarn remove node-sass
# 安装dart-sass（npm包名为`sass`）
yarn add sass --dev

项目中原有sass引用无需修改，dart-sass与node-sass API完全兼容。

2. 升级node-sass到兼容Node.js 18的版本 #

node-sass 8.x版本支持Node.js 18，执行以下命令升级：

yarn add node-sass@latest --dev

注意：升级后需检查项目中sass-loader等相关依赖版本是否匹配，避免编译错误。

3. 临时配置Python2路径 #

若需保留node-sass 4.x，可按以下步骤操作：

• 下载Python2.7安装包，安装时勾选「Add Python to PATH」；
• 若已安装但未加入PATH，执行命令指定路径：

  yarn config set python python2.7
  

• 重新执行yarn install。

二、依赖版本更新建议 #

根据npm outdated结果，分两类给出建议：

1. 优先更新（低风险，无破坏性变更） #

这类依赖的Wanted版本与Latest一致，属于同主版本的bug修复/小功能更新，直接更新即可：

• @material-ui/core：4.11.2 → 4.12.4
• dotenv：8.2.0 → 8.6.0
• history：5.0.0 → 5.3.0
• react-modal：3.11.2 → 3.16.1
• react-router-dom：5.2.0 → 5.3.4
• react：16.13.1 → 16.14.0
• react-dom：16.13.1 → 16.14.0
• reactfire：3.0.0-rc.0 → 3.0.0

2. 谨慎更新（高风险，存在破坏性变更） #

这类依赖跨主版本更新，API或使用方式有较大改动，需先阅读官方迁移文档，做好测试后再更新：

• @testing-library/jest-dom：4.x → 5.x
• @testing-library/react：9.x → 13.x
• @testing-library/user-event：7.x → 14.x
• firebase：8.x → 9.x（9.x采用模块化API，代码需大幅调整）
• react-scripts：3.x → 5.x（基于webpack5，需检查项目配置兼容性）
• node-sass：4.x → 8.x（已在前面的解决方案中覆盖）

内容的提问来源于stack exchange，提问作者Sultan Al-otaibi