macOS Big Sur下yarn install出现找不到Python可执行文件报错

首先明确报错根本原因：你当前项目依赖的node-gyp@3.8.0版本默认检索的Python 3.9路径/usr/local/opt/python@3.9/bin/python3和你本地Python的实际安装路径不匹配，你之前的操作失效多是因为npm的配置不作用于yarn、环境变量未生效两类问题。

可按以下步骤依次操作：

• 第一步：确认本地Python3的实际路径，终端运行命令 which python3，复制输出的完整路径备用。
• 第二步：给yarn单独配置Python路径，替换下方占位符后运行命令 yarn config set python /你刚才查到的Python3实际路径，解决npm配置不生效的问题。
• 第三步：清空之前的安装残留，避免缓存影响：
  • 删除本地项目的node_modules目录：rm -rf node_modules
  • 清空yarn全局缓存：yarn cache clean
• 第四步：重新执行依赖安装：yarn install

如果上述操作后仍然报错，可尝试临时指定环境变量执行安装：PYTHON=/你刚才查到的Python3实际路径 yarn install

如果还是出现相同报错，是因为项目嵌套依赖的旧版node-gyp不兼容macOS Big Sur的路径规则，可全局安装新版node-gyp覆盖旧版本：

• 运行命令全局安装最新版node-gyp：npm install -g node-gyp@latest
• 重复第三步的清空残留操作后重新执行安装即可。

内容的提问来源于stack exchange，提问作者J. Jackson