关键是统一源头、自动化部署、分层定制：通过team-dotfiles仓库集中管理配置并自动符号链接，mac cli标准化系统操作，powerlevel10k统一shell主题，vs code与iterm2配置同步，并采用基础层（强制）、标准层（默认）、个人层（本地覆盖）三层结构保障一致性与灵活性。
macos 下团队协作开发，关键不是堆砌工具，而是建立可复现、可共享、可维护的配置体系。真正高效的协作环境，依赖的是统一源头 + 自动化部署 + 分层定制能力，而不是靠手动安装、复制配置或各自为政。
用 team-dotfiles 统一终端与编辑器配置
把所有开发相关的配置文件（.zshrc、.p10k.zsh、VS Code settings.json、keybindings.json、extensions.list）集中存入一个私有 Git 仓库，比如 team-dotfiles。
- 根目录提供 install.sh 或 bootstrap.sh，自动创建符号链接（如
ln -sf ~/.dotfiles/zshrc ~/.zshrc） - 附带 brew.sh，声明团队必需工具清单（Git、Node.js、Docker、fzf、ripgrep 等），运行
brew bundle install即可批量安装 - 所有配置加注释，关键项标注“团队强制”或“建议修改”，新人拉代码、跑脚本，5 分钟完成基础环境搭建
用 Mac CLI 标准化系统级操作
避免各人用不同方式更新系统、排查端口、检查 Git 全局设置——这些动作必须收敛到统一命令入口。
- 通过官方脚本一键安装：
sh -c "$(curl -fsSL https://raw.githubusercontent.com/guarinogabriel/mac-cli/master/mac-cli/tools/install)" -
mac update：同步升级 macOS + Homebrew + npm + Rubygems，确保基础依赖版本一致 -
mac git:config：校验全局用户名、邮箱、commit template，防止提交信息不规范 -
mac ports：快速列出占用端口，协作调试时一眼发现冲突，减少“本地能跑，别人起不来”问题
用 Powerlevel10k + iTerm2 + VS Code Sync 保障视觉与行为一致
终端提示符结构、Git 状态显示、快捷键响应、扩展插件集合，这些细节直接影响协作效率和心理安全感。
- Shell 主题统一使用 Powerlevel10k，其 .p10k.zsh 由 dotfiles 控制，确保所有人看到的提示符完全一致
- iTerm2 配置导出为 JSON 存入仓库；VS Code 启用 Settings Sync（GitHub 登录）或直接纳入 dotfiles 管理
- 所有 IDE 和终端都指向同一源码路径（推荐用 iCloud 软链或 Syncthing 统一存储位置），避免路径差异引发构建失败
保留个人空间，不破坏团队基线
统一 ≠ 锁死。团队配置应分三层：基础层（强制）、标准层（默认启用）、个人层（本地覆盖）。
-
.zshrc 末尾自动加载
~/.zshrc.local（该文件不提交、不进仓库），供个人添加 alias 或临时 PATH - VS Code 的 workspace 设置仍可覆盖用户级配置，不影响团队基础规则
- 新成员入职只需 clone + run install.sh + 登录 GitHub 同步，无需理解每行配置含义
