关键在于分四阶段设计：系统预检与权限就绪、工具链分层安装与校验、环境配置与即时反馈、部署通道打通与冒烟测试，全程强调可重复、可验证、可中断，每步有反馈、失败能定位。
在 macos 上做自动化环境部署，关键不是堆工具，而是把“装什么、怎么装、装完怎么确认”拆清楚。整个流程围绕可重复、可验证、可中断三个目标设计，不追求一步到位，而强调每步有反馈、失败能定位。
阶段一：系统预检与权限就绪
脚本启动前先看底子牢不牢，避免后续卡在权限或空间上：
- 检查 macOS 版本是否 ≥ 12（
sw_vers -productVersion），低于则中止并提示升级路径 - 确认磁盘剩余空间 ≥ 20 GB（
df -h / | awk 'NR==2 {print $4}'），不足时给出清理建议目录（如~/Downloads、~/Library/Caches） - 自动启用必要系统权限：用
sudo sqlite3 /Library/Application\ Support/com.apple.TCC/TCC.db "INSERT OR REPLACE INTO access VALUES('kTCCServiceAccessibility','com.apple.Terminal',0,1,1,NULL,NULL);"开辅助功能；用osascript -e 'tell app "System Events" to set full disk access to true'请求全盘访问（需用户首次确认） - 关闭 Spotlight 对构建目录的索引：
mdutil -i off ~/Projects，防止编译时被意外扫描拖慢
阶段二：工具链分层安装与校验
按依赖层级安装，每层装完立刻验证核心命令是否可用，不等全部结束才报错：
- 先装 Xcode Command Line Tools（
xcode-select --install），再验证git --version和clang --version - 接着装 Homebrew（推荐清华源加速）：
/bin/bash -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.sh)"，装完立即运行brew doctor并过滤出真正阻断项 - 用 Brewfile 声明式安装工具组：CLI 工具（
git、jq、yq）、终端增强（zoxide、fzf）、开发语言（node、python@3.11、rustup），每类装完分别跑node -v、python3 -c "import sys; print(sys.version)"等最小验证 - 对需图形界面或登录的应用（如 Docker Desktop、1Password），只下载安装包、不自动启动，留白提示用户手动完成授权
阶段三：环境配置与即时反馈
配置不是写死一堆文件，而是让每个改动可感知、可回滚：
- Zsh 配置模块化：主
~/.zshrc只加载source ~/.zsh/functions和source ~/.zsh/plugins，各语言 SDK（如 Python 的 pyenv、Node 的 fnm）通过独立.zsh.d/xx.zsh文件按需激活，避免启动卡顿 - Git 全局设置自动生效：
git config --global user.name "Your Name"、git config --global init.defaultBranch main，然后立即执行git config --get user.name确认写入成功 - VS Code 设置同步：若已生成 GitHub PAT，则用
code --sync-on-startup启动并检查code --list-extensions是否包含常用插件（如 ESLint、Prettier），缺失则code --install-extension补齐 - 所有配置变更后，自动运行一次
source ~/.zshrc && echo "✅ Shell 环境已重载"，让用户看到实时响应
阶段四：部署通道打通与冒烟测试
最后一步不是“部署成功”，而是“能可靠交付”：
- SSH 免密验证：用
ssh -o ConnectTimeout=3 -o BatchMode=yes user@host exit 2>/dev/null && echo "✅ SSH 连通正常"快速探测，失败则提示ssh-copy-id user@host - Docker Desktop Kubernetes 启用后，立刻执行
kubectl get nodes -o wide和kubectl get pods -A，确认集群 Ready 且系统 Pod 正常运行 - 对本地运行的 CI 工具（如 act），用一个最小 workflow（仅 echo “hello”）验证能否拉镜像、跑步骤、输出日志，不依赖真实项目
- 最终生成一份简明报告：
deploy-report.txt，含时间戳、各阶段状态（✅/⚠️/❌）、关键版本号（macOS、Homebrew、Node、Python）、下一步手动操作提示（如“请打开 Docker Desktop 启用 Kubernetes”）
