macOS 系统下各种开发环境的故障处理预案-Mac OS-PHP中文网

homebrew安装失败或command not found，主因是网络不通（如curl: (7) failed to connect）或path未配置（apple silicon需加/opt/homebrew/bin，intel加/usr/local/bin），xcode cli工具缺失也会触发xcode-select错误。

macos 开发环境出问题，多数不是系统坏了，而是配置、权限或安全机制在“认真工作”。找准触发点，比硬重启或关防护更有效。

Homebrew 安装失败或命令找不到

报错常见于 curl: (7) Failed to connect to raw.githubusercontent.com 或执行 brew 时提示 command not found。本质是网络不通或路径没加进环境变量。

国内用户优先用镜像安装脚本：/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
装好后立刻切镜像源：git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
确保 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）已写入 ~/.zshrc，并执行 source ~/.zshrc

Xcode 命令行工具缺失

运行 git、make、clang 等时报 xcode-select: error: no developer tools were found，说明系统没装 CLI 工具，不是 Xcode 本体没装。

直接终端运行：xcode-select --install，弹窗点安装即可
若无反应，去 App Store 下载完整 Xcode，再运行：xcode-select -s /Applications/Xcode.app/Contents/Developer
验证是否生效：xcode-select -p 应输出类似 /Applications/Xcode.app/Contents/Developer

终端命令 not found 或 Permission denied

刚装的工具（如 nvm、pyenv、rustup）在新终端里用不了，或执行 pip install 报权限拒绝，大概率是路径没导、或误往 SIP 保护区写文件。

macOS Notes

通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载

检查 ~/.zshrc 是否含对应 export PATH=... 行，比如 nvm 要加：export NVM_DIR="$HOME/.nvm" 和 [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
避免用 sudo pip install——改用 pip install --user，二进制会落到 ~/Library/Python/x.x/bin/，再把该路径加进 PATH
手动编译软件时，指定前缀到用户目录：./configure --prefix=$HOME/local && make && make install

更新后软件打不开或驱动失效

macOS 小版本更新（如 15.4 → 15.4.1）后，NTFS 工具变只读、App 提示“已损坏”、Dock 图标点不动——这不是兼容性问题，是授权重置和隔离属性刷新导致的。

先看真实路径：进 /Applications 文件夹，右键 App → “在访达中显示”，确认文件名是否含中文/空格；旧 Dock 图标可能指向已不存在的路径
系统扩展被重置：打开 系统设置 > 隐私与安全性 > 安全性，找灰色提示“允许来自 XXX 的系统软件”，点“允许”并重启
绕过 Gatekeeper 隔离：sudo xattr -r -d com.apple.quarantine /Applications/YourApp.app（把 YourApp.app 换成实际名字，可直接拖入终端）