您现在的位置是: 网站首页> 精品案例 「解决该报错 + 完整安装 Homebrew」的步骤,兼顾官方源和国内镜像(解决网络超时问题),适配 zsh 终端:

「解决该报错 + 完整安装 Homebrew」的步骤,兼顾官方源和国内镜像(解决网络超时问题),适配 zsh 终端:

若谷 若谷 2025-12-08 180 人已围观 【演示URL:】

简介「解决该报错 + 完整安装 Homebrew」的步骤,兼顾官方源和国内镜像(解决网络超时问题),适配 zsh 终端:

出现 zsh: command not found: brew 说明你的 Mac 尚未安装 Homebrew(Mac 最常用的包管理器),以下是「解决该报错 + 完整安装 Homebrew」的步骤,兼顾官方源和国内镜像(解决网络超时问题),适配 zsh 终端:

一、前置准备:安装 Xcode 命令行工具

Homebrew 安装依赖 Xcode 命令行工具,先执行以下命令安装:
bash
运行
xcode-select --install 
  • 若提示「xcode-select: error: command line tools are already installed」,说明已安装,跳过此步;
  • 若弹出安装窗口,点击「安装」,等待完成即可(无需安装完整 Xcode,仅需命令行工具)。

二、安装 Homebrew(核心步骤)

方式 1:官方脚本安装(推荐,需外网通畅)

在 zsh 终端执行以下命令:
bash
运行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 
  • 安装过程中会提示输入电脑开机密码(输入时无字符显示,正常),按回车确认;
  • 等待安装完成(约 1-5 分钟,取决于网络)。

方式 2:国内镜像安装(解决网络超时 / 失败)

若官方脚本安装卡住 / 报错,用国内源(中科大镜像):
bash
运行
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" 
执行后按提示选择镜像源(推荐选「1. 中科大」),全程自动安装,无需手动操作。

三、验证 Homebrew 安装 & 解决 zsh 识别问题

1. 验证安装

安装完成后,执行以下命令:
bash
运行
brew --version 
  • 若输出版本信息(如 Homebrew 4.xx.x),说明安装成功;
  • 若仍提示 command not found,说明 zsh 未加载 brew 的环境变量,执行下一步。

2. 修复 zsh 环境变量(关键)

Homebrew 安装后,默认会把路径添加到 ~/.zshrc,但部分情况未生效,手动配置:
bash
运行
# 编辑 zsh 配置文件 open -e ~/.zshrc 
在文件末尾添加以下内容(根据 Mac 芯片选择,Intel 芯片和 M1/M2/M3 芯片路径不同):
  • M1/M2/M3 芯片(Apple Silicon)
    bash
    运行
    export PATH="/opt/homebrew/bin:$PATH" export PATH="/opt/homebrew/sbin:$PATH" 
  • Intel 芯片
    bash
    运行
    export PATH="/usr/local/bin:$PATH" export PATH="/usr/local/sbin:$PATH" 
保存文件后,执行以下命令让配置生效:
bash
运行
source ~/.zshrc 
再次执行 brew --version,此时应能正常显示版本。

四、安装完成后:继续安装 SVN(回到原需求)

brew 可用后,执行以下命令安装 SVN(命令行版):
bash
运行
# 安装 SVN brew install svn # 验证 SVN 安装 svn --version 
若需安装图形界面的 TortoiseSVN,继续执行:
bash
运行
brew install tortoisesvn 

五、常见问题解决

  1. 安装 brew 时提示「curl: (7) Failed to connect to raw.githubusercontent.com port 443」
    • 原因:外网访问受限,切换到「方式 2 国内镜像安装」即可;
    • 也可临时挂代理后再执行官方脚本。
  2. M1 芯片 brew 路径错误
    • M1 芯片的 brew 默认安装在 /opt/homebrew,而非 Intel 的 /usr/local,务必确认环境变量路径正确。
  3. brew 安装后提示「Warning: /opt/homebrew/bin is not in your PATH」
    • 直接执行上述「修复 zsh 环境变量」步骤,添加路径后 source ~/.zshrc 即可。

总结

  1. 先装 Xcode 命令行工具 → 再装 Homebrew(国内镜像更稳);
  2. 若 zsh 识别不到 brew,手动配置环境变量并生效;
  3. 验证 brew 可用后,即可正常安装 SVN 或其他工具。

相关文章

  • 「解决该报错 + 完整安装 Homebrew」的步骤,兼顾官方源和国内镜像(解决网络超时问题),适配 zsh 终端: 「解决该报错 + 完整安装 Homebrew」的步骤,兼顾官方源和国内镜像(解决网络超时问题),适配 zsh 终端: 「解决该报错 + 完整安装 Homebrew」的步骤,兼顾官方源和国内镜像(解决网络超时问题),适配 zsh 终端: 文章阅读

站点信息

程序员(若谷)的博客 微信公众号

售前客服:

售前客服微信

微信

售前客服微信
售前客服微信

微信

售前客服微信

售后客服:

售后客服微信

微信

售后客服微信