我之前也碰到过一模一样的问题！当时Homebrew把python3公式正式重命名为python，升级过程中因为旧路径缺失导致迁移失败，给你几个亲测有效的解决步骤：

步骤1：手动创建缺失的符号链接 #

报错核心是找不到/usr/local/opt/python路径，我们可以把已安装的python3路径链接到这个位置：

# 可选：先确认python3的实际安装路径
brew --prefix python3
# 创建符号链接
ln -s $(brew --prefix python3) /usr/local/opt/python

步骤2：重新执行升级命令 #

创建完链接后，再次运行升级命令：

brew upgrade python3

这时候Homebrew应该能正常完成迁移，把python3的公式切换到新的python公式。

步骤3：如果升级仍失败，尝试卸载重装 #

如果上面的步骤没用，可能是旧安装残留了损坏的文件，先卸载（注意备份你的Python虚拟环境和依赖）：

brew uninstall --force python3

然后直接安装最新的Python（现在Homebrew里python就是指Python3）：

brew install python

步骤4：清理旧链接和缓存 #

最后清理一下Homebrew的缓存和旧链接，确保环境干净：

brew cleanup
brew link --overwrite python

补充说明 #

这个错误的根源是Homebrew的公式迁移：官方把python3和python公式合并，升级时会自动尝试迁移到新的python公式，但如果系统中没有预先创建/usr/local/opt/python这个路径，就会触发找不到文件的错误。手动创建链接就能绕过这个问题。

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