出现 zsh: command not found: brew 说明你的 Mac 尚未安装 Homebrew(Mac 最常用的包管理器),以下是「解决该报错 + 完整安装 Homebrew」的步骤,兼顾官方源和国内镜像(解决网络超时问题),适配 zsh 终端:
Homebrew 安装依赖 Xcode 命令行工具,先执行以下命令安装:
-
若提示「xcode-select: error: command line tools are already installed」,说明已安装,跳过此步;
-
若弹出安装窗口,点击「安装」,等待完成即可(无需安装完整 Xcode,仅需命令行工具)。
在 zsh 终端执行以下命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-
安装过程中会提示输入电脑开机密码(输入时无字符显示,正常),按回车确认;
-
等待安装完成(约 1-5 分钟,取决于网络)。
若官方脚本安装卡住 / 报错,用国内源(中科大镜像):
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
执行后按提示选择镜像源(推荐选「1. 中科大」),全程自动安装,无需手动操作。
安装完成后,执行以下命令:
-
若输出版本信息(如
Homebrew 4.xx.x),说明安装成功;
-
若仍提示
command not found,说明 zsh 未加载 brew 的环境变量,执行下一步。
Homebrew 安装后,默认会把路径添加到 ~/.zshrc,但部分情况未生效,手动配置:
在文件末尾添加以下内容(根据 Mac 芯片选择,Intel 芯片和 M1/M2/M3 芯片路径不同):
-
M1/M2/M3 芯片(Apple Silicon):
export PATH="/opt/homebrew/bin:$PATH" export PATH="/opt/homebrew/sbin:$PATH"
-
Intel 芯片:
export PATH="/usr/local/bin:$PATH" export PATH="/usr/local/sbin:$PATH"
保存文件后,执行以下命令让配置生效:
再次执行 brew --version,此时应能正常显示版本。
brew 可用后,执行以下命令安装 SVN(命令行版):
brew install svn svn --version
若需安装图形界面的 TortoiseSVN,继续执行:
-
-
原因:外网访问受限,切换到「方式 2 国内镜像安装」即可;
-
也可临时挂代理后再执行官方脚本。
-
M1 芯片 brew 路径错误:
-
M1 芯片的 brew 默认安装在
/opt/homebrew,而非 Intel 的 /usr/local,务必确认环境变量路径正确。
-
brew 安装后提示「Warning: /opt/homebrew/bin is not in your PATH」:
-
直接执行上述「修复 zsh 环境变量」步骤,添加路径后
source ~/.zshrc 即可。
-
先装 Xcode 命令行工具 → 再装 Homebrew(国内镜像更稳);
-
若 zsh 识别不到 brew,手动配置环境变量并生效;
-
验证 brew 可用后,即可正常安装 SVN 或其他工具。
转载:非常感谢您对本平台的认可,此文章内容属于公司原创文章,如需转载请说明文章出处【URL:】。