1. Homebrew安装的死循环卡点先搞清楚你被卡在哪个环节如果你在Mac上装过Homebrew大概率经历过这种“死循环”官方命令/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)跑下去要么卡在下载要么提示网络错误要么总是让你安装Command Line Tools装完重试还是一样。更头大的是Intel Mac用户会发现以前能用的安装方式现在莫名其妙装不上了。先说结论Homebrew安装本质上只有两个前置条件一个是Command Line ToolsCLT另一个是网络能访问GitHub的raw资源和Homebrew的下载域名。你遇到的绝大多数报错都逃不出这两个范围。1.1 先确认Command Line Tools到底装好没有很多人有一个误解觉得“我装了Xcode”就等于有了CLT实际上Xcode和Command Line Tools是两套东西。CLT是精简版命令行工具集包含clang、git、make这些基础编译工具Homebrew安装时要用它来编译和校验环境。判断CLT是否装好最快的方式是打开终端执行xcode-select -p如果返回/Library/Developer/CommandLineTools说明CLT已经就位。如果提示error: unable to get active developer directory说明没装或路径丢失执行xcode-select --install系统会弹窗引导安装。这里有个很隐蔽的坑弹窗安装容易失败尤其是网络波动的时候安装进度条走完却没有任何提示你以为装好了其实没有。注意装完CLT后一定再执行xcode-select -p确认一次。我见过太多人卡在这一步反复执行Homebrew安装脚本每次都报同样的错实际上就是CLT没真正装上。如果你执行xcode-select --install弹窗一直不出现或者提示“软件包不可用”可以尝试直接去Apple开发者官网下载对应你系统版本的Command Line Tools dmg包手动安装。这个方法对Intel Mac尤其管用因为Apple对新版系统的CLT支持力度明显高于旧版。1.2 Intel Mac装不了Homebrew的真相“Intel Mac安装不了Homebrew了”这个话题最近特别热。其实Homebrew官方并没有彻底放弃Intel只是策略变了新版的安装脚本默认按照Apple Silicon的路径/opt/homebrew来装对Intel机器的支持被放到了次要位置。更关键的是Homebrew的install.sh脚本会检查系统版本和CLT版本如果你的Intel Mac系统版本比较旧比如macOS 10.15 Catalina或更早很可能触发兼容性检查失败报错信息类似Error: Your macOS version is too old.这并不代表你的机器不能装Homebrew。实践下来最稳的做法是使用国内镜像源或者手动指定安装前缀。比如使用中科大或清华的Homebrew镜像它们的安装脚本经过了适配绕过了官方脚本的版本校验。# 使用中科大镜像安装Homebrew /bin/bash -c $(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)这个脚本会自动检测你的CPU架构Intel Mac它会装到/usr/localApple Silicon装到/opt/homebrew。实测下来Intel Mac成功率高很多。1.3 网络层面的“伪失败”curl与raw.githubusercontent.com的连接还有一种情况是CLT没问题系统版本也支持但安装脚本本身跑不通——卡在下载Homebrew的压缩包阶段。这是最折磨人的因为Homebrew官方安装脚本会从raw.githubusercontent.com拉取核心仓库这个域名在国内的连通性极不稳定。判断是不是这个原因很简单单独执行curl -I https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh如果长时间没响应或报Failed to connect那就别跟官方源死磕了直接用镜像脚本一劳永逸。镜像脚本不仅替换了GitHub源还把Homebrew的bottle二进制包源也一并配置好后续brew install xxx的下载速度也会有明显改善。2. 搞清楚curl和wget在macOS上的真实处境接下来聊curl和wget。标题里把“成功安装curl、wget”放在一起但这里有个很多人没意识到的常识macOS自带curl且自带版本足够新。你需要的不是“安装curl”而是“搞清楚为什么curl不工作”以及“如何获得wget”。2.1 macOS自带的curl为什么偶尔不给力macOS系统自带的curl位于/usr/bin/curl基于libcurl编译功能上支持HTTP、HTTPS、FTP等主流协议。但它有几个天然的槽点第一系统自带的curl证书库路径和Linux发行版不同。Linux上curl读取/etc/ssl/certs下的CA证书macOS则使用Keychain里的证书。这个差异在访问某些自签名证书或内网HTTPS服务时特别明显你会遇到SSL certificate problem: unable to get local issuer certificate。这不是curl本身的bug而是证书信任链的问题。第二系统curl版本可能跟你预期的行为不一样。比如新版curl默认不跟随重定向需要加-L参数默认不校验完整有些网址需要-k才能通。很多脚本报错其实都是参数没用对。围绕热词里提到的curl -k --location这里做个简单拆解-k全称--insecure表示跳过SSL证书校验。只在访问自签名证书或测试环境时使用生产环境不要养成这个习惯。从热词里看到的curl: (60) ssl certificate problem就是典型的证书校验失败临时用-k不报错但根治方案是把对应证书加入信任列表。--location简写-L表示如果服务器返回301/302重定向curl会自动跟随到新的地址。不带-L时curl只会显示重定向响应头不会下载最终资源。2.2 wget在macOS上为什么默认不存在wget和curl功能重叠度很高但wget更偏“下载器”递归下载、断点续传、批量镜像这些场景比curl更顺手。macOS偏偏不预装wget所以很多从Linux切到Mac的人第一反应就是装wget。装wget的路径依赖你有没有Homebrew有Homebrewbrew install wget一行搞定会自动处理依赖如libidn2、openssl。没有Homebrew要么走上面镜像脚本先把Homebrew装上要么用curl造一个“伪wget”——毕竟在装好Homebrew之前你的macOS已经有curl可用了。如果你只是想要wget的断点续传能力用curl也能实现# curl断点续传下载-C -表示自动续传 curl -C - -O https://example.com/package.zip这个技巧在被中断的下载场景里很实用。我从Linux迁移到macOS初期就是用这条命令熬过了“还没有Homebrew环境”的尴尬期。2.3 系统自带curl和Homebrew版curl并存时的调用优先级装完Homebrew后brew install curl会编译一份新版本curl放在/opt/homebrew/opt/curl/bin/curlIntel类似路径是/usr/local/opt/curl/bin/curl。这就出现一个局面系统有/usr/bin/curlHomebrew也有一个curl到底用哪个Homebrew官方为了避免混乱把新版curl做成了keg-only只装在独立目录不自动链接到/usr/local/bin。你的shell默认还是会调用系统curl。如果你需要用到新版curl的特性比如HTTP/3支持、更完善的重试机制需要手动添加PATHecho export PATH/opt/homebrew/opt/curl/bin:$PATH ~/.zshrc我这里给的是Apple Silicon的路径Intel Mac把/opt/homebrew换成/usr/local即可。加完之后curl --version显示的版本会变成Homebrew编译的新版。经验之谈如果你只是日常请求HTTP接口、下载文件系统自带curl完全够用没必要非得升级。只有当你确定要依赖某个curl新特性或者系统curl的证书处理总是给你添麻烦时再考虑让Homebrew版curl接管。3. 安装失败的典型现场从排查到破解现在把安装过程中最容易翻车的几个场景集中说一下。每一个都是我实测踩过或帮人排查过的给出完整链路而不是直接甩答案这样你再遇到类似问题能自己定位。3.1 连接超时与端口残留curl error 7这类问题怎么定位装Homebrew时最常见的网络报错之一是curl: (7) Failed to connect to raw.githubusercontent.com port 443: Connection refusederror 7的含义是TCP层连接失败——根本没连上目标服务器的443端口。原因可能是目标域名被重置、本机防火墙拦截也可能是你的shell环境里残留了代理变量。很多人在Mac上折腾过本地代理工具有些工具会在~/.zshrc或~/.bash_profile里写入HTTP_PROXY和HTTPS_PROXY环境变量。这些变量一旦设置curl、wget、git这些命令都默认走代理。如果代理工具已经退出但环境变量还在你curl出去的请求会打到127.0.0.1:7897之类的本地端口然后被拒绝。热词里那条curl: (7) failed to connect to 127.0.0.1 port 7897就是典型残留场景其中7897是本地代理的监听端口。排查链路如下# 1. 查看当前shell的代理相关环境变量 env | grep -i proxy如果输出里有http_proxy、https_proxy、all_proxy这类变量基本就实锤了。临时取消代理unset http_proxy https_proxy all_proxy再执行curl测试如果能通说明就是环境变量残留。根治方案是编辑~/.zshrc删掉或注释掉代理相关的export行然后source ~/.zshrc。如果env | grep -i proxy没有输出但curl依然报error 7那大概率是raw.githubusercontent.com这个域名直连确实不行。此时执行ping raw.githubusercontent.com看解析结果如果IP能解析但TCP连接失败直接换镜像脚本。3.2 SSL证书报错curl error 60的快速解法与根治思路curl: (60) SSL certificate problem: unable to get local issuer certificate也是一个高频错误。这表示curl在验证服务器证书时找不到可信任的中间证书。出现这个报错有三种常见原因系统时钟不准——证书有有效期校验本机时间偏差过大时直接判死。执行date看下时间不对就打开“系统设置 日期与时间”开启自动同步。访问的是自签名或内网证书服务——比如热词里那个https://esign.cqipu.edu.cn:9100的场景学校或企业内网经常用自签证书。临时用curl -k绕过校验可以但根治方式是把服务端的CA证书加到系统Keychain里用“钥匙串访问”App把证书文件拖入“系统”钥匙串双击后展开“信任”把“使用此证书时”改为“始终信任”。CA证书库不完整——某些精简过的macOS系统或第三方构建的curl证书库文件缺失。Homebrew版curl会使用ca-certificates包提供的证书库此时brew install ca-certificates通常能修复。这类问题在安装Homebrew时不多见但后续你用curl访问各种服务和内网资源时会频繁遇到值得记下排查思路。3.3 Homebrew“装到一半失败”的残留处理有一种极其常见的场景安装脚本跑了一部分报错中断你换个脚本重装结果又报“GitHub API rate limit exceeded”或“Directory not empty”。这是Homebrew的安装残留导致的。install.sh脚本会在/opt/homebrew或/usr/local创建目录结构。如果中途失败目录是半成品状态。再次安装时脚本发现目录存在且不是合法仓库就会报冲突。处理方式不是简单rm -rf /opt/homebrew而是先看有没有已经安装成功的包需要保留通常不会有因为半途失败基本什么都没装上然后# 彻底清理Homebrew残留按自己的架构选择路径 sudo rm -rf /opt/homebrew sudo rm -rf /usr/local/Homebrew # 清理CLT阶段可能产生的临时文件 sudo rm -rf /Library/Developer/CommandLineTools最后一步清理CLT要慎重你是在CLT本身损坏或编译环境异常时才需要这么做。清理之后重新xcode-select --install。还有个隐藏残留~/.homebrew或~/.linuxbrew目录。有些老教程让人把Homebrew装到用户目录如果你照着做过再次安装前也要清掉rm -rf ~/.homebrew另外brew install阶段如果网络中断也可能在~/Library/Caches/Homebrew下留下损坏的下载缓存。重试前可以清空这个目录rm -rf ~/Library/Caches/Homebrew/downloads3.4 从零到可用的最小路径无Homebrew环境拿到wget如果你现在的状态是没有Homebrew、没有wget只有系统自带curl和xcode-select --install能装上CLT。你其实已经能编译安装wget了。wget依赖libssl、libidn2、libpsl等几个库纯手动编译比较费劲。我的建议是如果你只是想用wget的功能先别折腾编译直接用curl顶替。如果非要wget最快的路径反而是先把Homebrew装好。但装Homebrew在这里又变成了一个“先有鸡还是先有蛋”的问题——因为它本身也依赖curl。好消息是macOS自带curl所以你永远有最小可用工具链。我实测过一条有效的最小安装链路先用xcode-select --install装好CLT这提供编译器和git。使用中科大镜像脚本安装Homebrew这会同时解决GitHub连通性问题。brew install wget依赖由Homebrew自己处理。这个过程即使网络环境不理想也比官方脚本成功率高得多。4. zsh配置与Oh My Zsh从确认Shell到实用插件Homebrew、curl、wget都就位后就是标题里的第三块——配置zsh。macOS从Catalina开始默认Shell就是zsh但很多人并没有真正“配置”过它只是换了一层皮。配置zsh的核心是把工作流效率提起来而不是把终端搞得花里胡哨。4.1 怎么确认当前Shell并切换执行echo $SHELL如果输出/bin/zsh说明默认Shell已经是zsh。如果你之前手动切换过别的Shell比如bash要切回zshchsh -s /bin/zshchsh命令会修改/etc/shells里记录的登录Shell。切换后重开终端生效。这里有个细节zsh的配置加载顺序是/etc/zprofile/etc/zshrc~/.zprofile~/.zshrc~/.zlogin日常配置主要写在~/.zshrc里。而~/.zprofile适合放环境变量和登录时需要执行的初始化命令两者有区别。Homebrew官方建议把eval $(/opt/homebrew/bin/brew shellenv)放在~/.zprofile里如果你用的.zshrc也可以但官方定位是登录Shell时执行。4.2 Oh My Zsh安装curl或wget选择其一Oh My Zsh的官方安装命令也依赖curl或wget# 用curl sh -c $(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh) # 用wget sh -c $(wget -qO- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)-fsSL这四个参数是curl静默且安全的组合-f表示失败时不输出错误页面内容-s静默模式-S出错时显示错误信息-L跟随重定向。如果没有-Lraw.githubusercontent.com一旦返回重定向下载的就不是真正的安装脚本。同样的问题这个域名在国内连通性不稳定。如果你的Oh My Zsh安装卡住直接用gitee镜像sh -c $(curl -fsSL https://gitee.com/mirrors/oh-my-zsh/raw/master/tools/install.sh)实测gitee镜像安装Oh My Zsh速度很快安装完成后需要手动把仓库远程地址指向giteecd ~/.oh-my-zsh git remote set-url origin https://gitee.com/mirrors/oh-my-zsh.git否则后续omz update更新插件时会卡在GitHub上。4.3 让zsh真正趁手的配置清单配置zsh不是为了好看是为了减少重复劳动。我推荐的最小实用配置包括以下内容主题选择ZSH_THEMErobbyrussell是默认主题够用但信息量少。我更推荐ys或agnoster后者需要配合Powerline字体。如果装了powerlevel10k配置会更复杂但体验最好。新手建议先用内置ys主题关注点放在插件上。插件是zsh的灵魂。Oh My Zsh自带了很多插件默认只开了git。可以编辑~/.zshrc里的plugins(git)这一行plugins(git z zsh-autosuggestions zsh-syntax-highlighting)其中z是内置插件作用是目录快速跳转——你在某个目录待过一段时间后直接输入z 目录名就能跳过去不用打全路径。zsh-autosuggestions和zsh-syntax-highlighting需要单独安装# 自动建议插件 git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions # 语法高亮插件 git clone https://github.com/zsh-users/zsh-syntax-highlighting ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting如果你GitHub连接有问题用gitee的镜像地址替换github.com比如https://gitee.com/dawn_a_zhao/zsh-autosuggestions.git这类镜像。启用插件后执行source ~/.zshrc生效。zsh-autosuggestions会在你输入命令时用灰色字体提示历史命令按→键自动补全这个体验用惯了就回不去。zsh-syntax-highlighting让合法命令是绿色、非法命令是红色极大减少手误。alias别名配置。在~/.zshrc里加一段自己常用的别名alias clclear alias llls -lah alias gsgit status alias gpgit pull alias glgit log --oneline --graph alias ..cd .. alias ...cd ../..我的建议是别抄一堆别人的alias只加你日常确实高频敲的命令。alias本身不提升系统性能只减少按键次数加太多用不上反而增加记忆负担。4.4 Homebrew和zsh的联动brew shellenv与PATH的顺序配置好zsh后一个最容易忽略的问题是PATH顺序。Homebrew安装完成后输出信息里有这么一行提示 Next steps: - Run these two commands in your terminal to add Homebrew to your PATH: echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile eval $(/opt/homebrew/bin/brew shellenv)这里使用了brew shellenv而不是把/opt/homebrew/bin直接加入PATH区别在于brew shellenv会输出一组环境变量设置包括PATH、HOMEBREW_PREFIX、HOMEBREW_CELLAR等而且它不仅仅是加一个路径会把/opt/homebrew/bin放在PATH的最前面。这个顺序很关键。如果PATH前面有/usr/bin那么执行python3时系统会优先使用/usr/bin/python3而不是Homebrew版的python3这会导致你brew install python后敲python3还是“旧版”。出现这种“安装了但用不上”的问题第一反应应该检查echo $PATH里Homebrew路径的位置。注意不要在~/.zshrc和~/.zprofile里重复追加brew shellenv。重复执行不会报错但PATH里会出现多项重复路径虽然无害却会让排查问题时多一层噪音。还有一个易错点如果你把eval $(/opt/homebrew/bin/brew shellenv)同时写进了.zprofile和.zshrc在zsh下启动新终端时两个文件都会被加载.zprofile是登录Shell时加载.zshrc是交互Shell时加载设置会执行两边。规范做法是只放在其中一个文件里官方推荐.zprofile。5. Command Line Tools与权限问题收尾阶段最容易翻车的两个坑装完Homebrew、配好zsh看起来大功告成但你在第一次brew install xxx时很可能遇到权限报错或“git安全目录”报错。这里集中处理。5.1 “git安全目录”报错的解决新装的Homebrew在首次brew update或brew install时有时会报fatal: detected dubious ownership in repository at /opt/homebrew/Library/Taps/homebrew/homebrew-core这个报错的本质是Git检测到仓库所有者与当前用户不一致。当你用sudo执行过某些操作后/opt/homebrew目录的文件owner会被改成root然后当前用户再访问时Git就认为“这个仓库不是我的可能被篡改”。解决方案有两种# 方法一把目录owner改回当前用户推荐 sudo chown -R $(whoami):admin /opt/homebrew # 方法二把目录加入Git的安全白名单治标不治本 git config --global --add safe.directory /opt/homebrew/Library/Taps/homebrew/homebrew-core方法二只是在Git全局配置里加了个白名单如果还有其他子目录也报同样错误还得一条条加。方法一从根上解决执行一次即可后续不会再出现。这个问题在“帮朋友装环境”的场景里特别常见——你用自己的管理员账户帮别人跑命令或者用sudo提权后忘了检查文件owner后面就容易被这个报错困扰。5.2 /usr/local目录权限问题Intel Mac的遗留坑Intel Mac上Homebrew安装在/usr/local这个目录下不只是Homebrew一个用户系统本身的一些工具也在这里。一旦目录权限被改动比如你用sudo chown -R改动过可能导致brew命令行为异常比如Error: /usr/local/opt is not writable.解决方案是sudo chown -R $(whoami):admin /usr/local但在某些系统版本下/usr/local下还有/usr/local/bin、/usr/local/share等目录是系统特殊处理的直接对整个/usr/local执行chown可能会引发其他问题。保守做法是只修复Homebrew实际用到的子目录sudo chown -R $(whoami):admin /usr/local/bin /usr/local/etc /usr/local/lib /usr/local/opt /usr/local/share /usr/local/var完成后再执行brew doctor检查看到Your system is ready to brew就说明环境健康。5.3 brew doctor与brew config如何自查环境健康状况无论你装了什么、改了什么建议养成一个习惯装完新工具后跑一遍brew doctor。它会输出当前Homebrew环境的所有异常包括未清理的旧版本、可疑的PATH配置、权限问题等。还有一个经常被忽略的命令是brew config它会列出Homebrew版本、CLT版本、macOS版本、CPU架构、Rosetta状态、编译器版本等关键信息。在给别人描述问题时直接贴brew config的输出比口头描述要高效得多。热词里提到的“mac安装不报错但装不上”这一类问题多半也藏在这些配置细节里。比如Apple Silicon Mac上执行了Intel版本的CLTRosetta环境或者CLT版本和Xcode版本冲突这些在brew config的输出里都有迹可循。5.4 一个好习惯用/opt/homebrew/bin/brew check前缀排查最后分享一个排查技巧。当你遇到brew相关命令行为异常但不确定是brew本身的问题还是PATH里其他工具干扰时用绝对路径执行brew/opt/homebrew/bin/brew doctor这样可以绕开shell里alias和PATH的干扰直接验证brew本体是否正常。同理排查curl时用/usr/bin/curl --version绕开Homebrew版curl的干扰。这类“用绝对路径隔离变量”的思路在排查一系列“为什么命令行为不一致”问题时非常有效。如果/opt/homebrew/bin/brew doctor正常但直接执行brew doctor报错那问题一定出在shell配置或PATH里优先检查~/.zshrc和~/.zprofile。如果绝对路径本身就报错则优先检查CLT和目录权限。6. 一波三折后的经验补充网络诊断三件套整个安装过程绕不开一个底层能力诊断网络问题。不管你是用curl装Homebrew、克隆插件还是跑安装脚本网络不通都是第一拦路虎。给新手分享三个基础但极好用的网络诊断命令。6.1 连通性诊断ping与nc# 测试域名能否解析和ping通 ping -c 4 raw.githubusercontent.com # 测试TCP端口是否可连通比如443 nc -vz raw.githubusercontent.com 443nc -vz会显示Connection succeeded或Connection refused比ping更能反映真实的连接状态。如果你ping能通但nc失败说明TCP层被阻断如果nc能通但curl仍报错问题大概率在HTTP层证书、代理、重定向等。6.2 链路诊断curl verbose模式curl的-v参数会打印完整的请求过程包括DNS解析结果、TCP连接、TLS握手、请求头和响应头。这个输出遇到问题时的价值远超报错信息本身。curl -v https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh -o /dev/null观察输出如果卡在Trying 127.0.0.1...说明有代理变量在拦截。如果显示Connected to raw.githubusercontent.com (IP) port 443后TLS报错说明证书链有问题。如果显示Recv failure: Connection reset by peer说明连接被重置大概率域名被干扰。6.3 域名解析诊断dig有时候DNS解析结果本身有问题。比如解析出的IP不是预期的IP或者DNS缓存了旧的记录。用dig查看dig short raw.githubusercontent.com如果返回的IP明显异常比如指向内网地址或某个广告IP考虑清理DNS缓存或更换DNS服务器。macOS清理DNS缓存sudo dscacheutil -flushcache sudo killall -HUP mDNSResponder这三件套配合使用能定位80%以上的“curl装不上东西”类问题。即便以后不装Homebrew它们也会在每次下载源码、调用API时反复用到。我在实际配置过程中发现Mac的终端环境搭建是个“越用越复杂”的过程——装好Homebrew后你会忍不住装更多工具装完工具又可能遇到新的冲突。不过只要建立起了“CLT确认、网络诊断、权限检查、PATH顺序”这四层排查意识后续几乎所有安装类报错都能自己定位。这里面的核心还是别怕报错报错信息本身就是在告诉你下一步该查什么。