macOS开发辅助脚本核心是可验证、可跳过、可重入，重点适配Apple Silicon与Intel架构差异、避开系统拦截、提前检查依赖；安装前须手动确认三件事：Xcode命令行工具已安装、辅助功能权限已启用、shell为zsh。
macos 安装与管理系统的开发辅助脚本，核心不是堆功能，而是让每一步可验证、可跳过、可重入。重点在适配 apple silicon 与 intel 架构差异、避开系统级拦截、提前检查依赖状态，避免“跑一半失败还得手动擦屁股”。
安装前必须确认的三件事
脚本执行前手动确认，比写一堆错误处理更高效：
- 运行
xcode-select --install并完成弹窗安装——这是所有后续命令（git、make、clang）的底层依赖，无法静默跳过 - 检查是否已启用“辅助功能”权限：系统设置 → 隐私与安全性 → 辅助功能 → 勾选脚本编辑器、iTerm2、AltTab 等工具（否则 AppleScript / JS Automation / CLI 窗口控制会静默失败）
- 确认 shell 类型：
echo $SHELL应为/bin/zsh；若仍是/bin/bash，先运行chsh -s $(which zsh)，再重启终端
Homebrew 安装与路径适配脚本
Apple Silicon 和 Intel 的 Homebrew 默认路径不同，硬编码会导致安装失败或命令找不到：
- 检测架构并自动选择路径：
if [[ $(uname -m) == "arm64" ]]; then BREW_PREFIX="/opt/homebrew"; else BREW_PREFIX="/usr/local"; fi - 安装后立即注入 PATH：
echo "export PATH=\"$BREW_PREFIX/bin:\$PATH\"" >> ~/.zshrc && source ~/.zshrc - 加存在性检查，避免重复安装：
if ! command -v brew > /dev/null; then /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"; fi
常用开发工具一键安装脚本
不追求“全装”，只装真正高频使用的，并附带基础配置：
- iTerm2 + VS Code：
brew install --cask iterm2 visual-studio-code
安装后自动注册命令行：code --install-extension ms-vscode.vscode-typescript-next - Zsh 增强（可选但推荐）：
brew install starship，然后在~/.zshrc末尾追加eval "$(starship init zsh)" - 关键 CLI 工具统一安装：
brew install git python3 nodejs jq curl wget tree ripgrep fd
系统级自动化任务脚本编写要点
用脚本管理 macOS 本身（非开发工具），需绕开系统限制并留退路：
- 禁用 Gatekeeper 仅限首次（如需安装未公证的 cask）：
sudo spctl --master-disable 2>/dev/null || true，执行后提示用户手动在系统设置中重新启用 - 字体安装后刷新缓存：
cp ~/Downloads/*.ttf ~/Library/Fonts/ && fc-cache -fv，否则终端/编辑器看不到新字体 - 窗口管理类脚本（如 AltTab）必须前置检测：
if ! pgrep -x "AltTab" > /dev/null; then open -a "AltTab"; fi，避免因进程未启动导致--list返回空
