macOS下Homebrew因版本值无效无法运行，求助解决方案

算力阿峰

2026-8-2

解决Homebrew启动时的Version TypeError错误

你遇到的错误是Homebrew读取Mac系统版本时出现类型异常，导致无法初始化，具体错误栈：

"/usr/local/Library/Homebrew/version.rb:186:in `initialize': Version value must be a string (TypeError)
    from /usr/local/Library/Homebrew/os/mac/version.rb:24:in `initialize'
    from /usr/local/Library/Homebrew/os/mac.rb:15:in `new'
    from /usr/local/Library/Homebrew/os/mac.rb:15:in `version'
    from /usr/local/Library/brew.rb:31:in `<main>'"

试试下面几个解决方法：

确认系统版本读取是否正常
打开终端执行 sw_vers，查看输出的ProductVersion字段，确认是类似14.3.1的合法字符串。如果这个字段为空或格式异常，先尝试重启系统，或检查系统设置里的版本信息是否正常显示。
卸载并重装Homebrew
这是最直接的修复方式，大概率是Homebrew核心文件损坏导致的。先执行卸载命令：
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
```
卸载完成后，再执行安装命令重装：
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
注意：卸载会移除所有通过Homebrew安装的包，需要保留的话可以先备份/usr/local/Cellar目录，重装后将备份文件放回该目录即可。
临时指定系统版本环境变量（应急方案）
如果暂时不想卸载重装，可以手动设置环境变量让Homebrew正确识别版本：
```
export HOMEBREW_MACOS_VERSION=$(sw_vers -productVersion)
```
执行后再尝试运行brew，如果能正常使用，把这条命令添加到你的shell配置文件（比如~/.zshrc或~/.bash_profile）中，后续打开终端会自动加载该变量。