核心是统一配置源、自动化部署、分层可定制:通过 git 管理 team-dotfiles 仓库实现终端/ide 配置同步,mac cli 标准化系统操作,powerlevel10k 统一 shell 主题,并分基础层(强制)、标准层(默认)、个人层(本地覆盖)保障一致性与灵活性。
核心是统一配置源、自动化部署、分层可定制。不靠手动复制,而靠可复现的流程和共享的配置仓库。
用 Git 管理团队 dotfiles 仓库
把所有终端配置(.zshrc、.p10k.zsh)、编辑器设置(.vimrc、VS Code settings.json)、常用别名和函数,全部纳入一个私有 Git 仓库,比如 team-dotfiles。
- 仓库根目录放 install.sh 或 bootstrap.sh,自动创建符号链接(如
ln -sf ~/.dotfiles/zshrc ~/.zshrc) - 包含 brew.sh 脚本,声明团队必需工具清单(Git、Node.js、Docker、fzf、ripgrep 等),运行
brew bundle install即可批量安装 - 所有配置文件加注释说明用途,关键参数标注“团队强制”或“建议修改”
集成 Mac CLI 统一系统级操作
Mac CLI 是面向团队的 macOS 命令行管理工具,能标准化系统维护动作,避免各人用不同方式更新或排查。
- 用官方脚本一键安装:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/guarinogabriel/mac-cli/master/mac-cli/tools/install)" - 团队共用 mac update 更新系统 + Homebrew + npm + Rubygems,确保基础依赖版本一致
- 用 mac git:config 检查全局 Git 用户名/邮箱/commit template,防止提交信息不规范
- 通过 mac ports 快速发现端口冲突,协作调试时减少“本地能跑,别人起不来”的问题
终端与 IDE 配置同步到多设备
iTerm2 和 VS Code 的配置不随系统迁移,需显式同步,但无需第三方服务。
- iTerm2:导出 JSON 配置(Preferences → Profiles → Other Actions → Export JSON),存入 dotfiles 仓库;新设备导入即可
- VS Code:启用 Settings Sync(需 GitHub 登录),或把 settings.json、keybindings.json、extensions.list 全部纳入 dotfiles 管理
- Shell 主题统一用 Powerlevel10k,配置文件 .p10k.zsh 由 dotfiles 控制,确保提示符结构、Git 状态显示完全一致
保留个性化空间,不牺牲团队一致性
统一 ≠ 一刀切。团队配置应分三层:基础层(强制)、标准层(默认启用)、个人层(可选覆盖)。
- 在 .zshrc 末尾自动加载 ~/.zshrc.local(该文件 不在 dotfiles 仓库中,不提交),供个人添加 alias 或 PATH
- VS Code 的 workspace 设置仍可覆盖用户级设置,不影响团队基础规则
- Mac CLI 支持自定义命令插件,团队可维护 mac team:setup 封装内部 CI 工具链或私有 registry 配置











