macos下最推荐的版本控制工具是git,安装首选homebrew(brew install git),其次xcode命令行工具或官方.pkg包;必须配置全局用户名与邮箱、启用osxkeychain凭证缓存、设置~/.gitignore_global忽略临时文件。
macos 下最常用、最推荐的代码版本控制工具是 git,它轻量、高效、生态成熟,且与 github、gitlab 等平台深度集成。安装和配置并不复杂,但关键步骤不能跳过——尤其是用户身份、凭证管理和全局忽略规则。
安装 Git(三种可靠方式)
macOS 系统默认不预装 Git,需手动安装。推荐按优先级选择以下任一方式:
-
Homebrew 安装(首选):适合大多数开发者,能持续更新、版本较新、路径清晰。
先确认 Homebrew 是否已装:brew --version;未装则运行:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
再执行:brew install git,完成后用git --version验证。 -
Xcode 命令行工具安装(系统级):不依赖第三方包管理器,Git 位于
/usr/bin/git,适合追求稳定或企业合规环境。
终端中直接运行:xcode-select --install,按弹窗提示完成安装后,用which git确认路径。 -
官方 .pkg 安装包(图形化):适合新手或需指定版本的用户。
访问 https://www.php.cn/link/5f2397a240ce3565d4d3b82b0db2fc65,自动匹配 Apple Silicon 或 Intel 芯片下载最新安装包,双击运行,勾选“Install for all users”即可。
配置基础身份信息(必需)
Git 提交记录必须关联作者身份,否则无法正常推送或协作。该配置只需一次,作用于所有本地仓库:
- 设置全局用户名:
git config --global user.name "Your Name" - 设置全局邮箱:
git config --global user.email "you@example.com" - 查看是否生效:
git config --global --list,应看到user.name和user.email两行
注意:此处邮箱不要求真实可收信,但建议与 GitHub/GitLab 账号一致,便于提交记录自动关联。
启用钥匙串凭证缓存(省去重复输密)
每次向远程仓库 push 或 pull 时,若用 HTTPS 协议,会反复要求输入账号密码。启用 macOS 钥匙串集成后,首次验证通过即自动保存:
- 执行:
git config --global credential.helper osxkeychain - 后续首次 push 会弹出钥匙串授权窗口,勾选“始终允许”即可
- 之后所有操作不再提示,凭证安全存储在系统钥匙串中
设置全局 .gitignore(避免误提交垃圾文件)
每个项目单独写 .gitignore 很麻烦,macOS 开发中大量临时文件(如 .DS_Store、__pycache__、.vscode/)应统一屏蔽:
- 创建文件:
touch ~/.gitignore_global - 编辑并填入常用规则(可用 nano 或 VS Code):
*.DS_Store<br>.Spotlight-V100<br>.Trashes<br>~*<br>*~<br>.vscode/<br>.idea/<br>__pycache__/
- 启用该文件:
git config --global core.excludesfile ~/.gitignore_global
验证方法:进任意 Git 仓库,执行 touch test.DS_Store && git status,该文件不应出现在未跟踪列表中。
可选增强:Git LFS(大文件支持)
若项目含设计稿、音视频、模型权重等大文件,建议安装 Git LFS,避免仓库臃肿:
- 安装:
brew install git-lfs - 初始化:
git lfs install - 跟踪特定类型(如 PSD 文件):
git lfs track "*.psd",再提交.gitattributes
Git LFS 不改变工作流,仅将大文件替换为指针,拉取时按需下载实际内容。











