在macOS系统下进行版本控制开发，Git和SVN是最常用的两种工具。很多开发者拿到新电脑或重装系统后，需要重新配置环境。下面这篇教程将用最直接的方式，带你一步步完成Git和SVN的安装与基础配置，全程无需复杂命令，适合新手和老手快速上手。
安装前的准备工作
macOS自带了基础的命令行环境，但官方并没有预装Git和SVN。为了稳定且方便管理依赖，强烈建议先安装Homebrew。打开终端，复制粘贴以下命令并回车：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。安装过程中会提示输入密码，按提示操作即可。等待进度条走完，Homebrew就配置好了。如果你的网络环境访问GitHub较慢，可以提前配置国内镜像源，这样后续下载软件会快很多。
Mac安装Git的详细步骤
Git是目前最主流的版本控制系统。安装方式有两种，推荐第一种。方法一：使用Homebrew安装。在终端输入 brew install git，系统会自动下载并配置最新稳定版。安装完成后，输入 git --version 验证，看到版本号即代表成功。方法二：官网下载安装包。访问Git官网下载dmg文件，双击运行安装程序，一路点击继续即可完成。这种方式适合不想用命令行管理的用户。
安装完毕后，建议立即设置用户名和邮箱，否则提交代码时会报错。在终端依次执行以下两条命令，把引号内的内容换成你自己的信息：git config --global user.name "你的名字" 和 git config --global user.email "你的邮箱地址"。这样每次你在本地仓库执行commit操作时，系统就会自动带上你的身份信息。
Mac安装SVN的操作指南
部分传统企业或老项目依然在使用SVN进行代码管理。虽然macOS历史上曾内置过SVN客户端，但在较新的系统版本中已被移除，需要手动装回。推荐直接使用Homebrew一键搞定。终端输入 brew install svn，等待几秒到几分钟不等，取决于网络状况。安装结束后，输入 svn --version 检查是否生效。如果返回1.14或更高版本号的提示，说明环境已经就绪。
如果你习惯图形界面操作，也可以去Apache Subversion官网下载命令行工具包，或者安装TortoiseSVN的macOS移植版。不过对于日常开发，命令行配合VSCode或Xcode的插件已经完全够用。SVN安装好之后，基本不需要额外配置。它默认会读取当前用户的家目录作为缓存路径。如果需要连接内网服务器，只需在终端输入 svn checkout 仓库地址 本地文件夹名，按照提示输入账号密码即可拉取代码。
常见问题与避坑建议
安装过程中可能会遇到权限拒绝或证书验证失败的问题。如果是权限问题，检查终端是否以管理员身份运行，或者在brew install前加上 sudo（注意现在Homebrew不鼓励滥用sudo）。如果是SSL证书错误，通常是系统时间不对或根证书过期，校准系统时间并重启终端即可解决。
另外，Mac更新系统后偶尔会导致命令行工具链失效。如果发现git或svn突然找不到命令，可以尝试在终端运行 xcode-select --install 重新安装命令行工具集。这个操作不会动你现有的代码和数据，只是修复底层编译环境。最后提醒一点，Git和SVN的工作流差异很大。Git是分布式版本控制，每个本地都是完整仓库；SVN是集中式，所有记录都在中央服务器。切换项目类型时，记得清理本地的隐藏配置文件，避免指令冲突。可以用 rm -rf .git 删除Git痕迹，用 rm -rf .svn 清理SVN元数据。
总结
在Mac上搭建Git和SVN环境其实并不复杂，核心就是利用Homebrew统一管理软件包，并做好基础的身份配置。掌握这两个工具的安装与验证方法，就能顺利接入绝大多数开发团队的工作流。遇到报错时，优先检查版本号、网络代理和系统权限，百分之九十的问题都能快速定位。祝你开发顺利，代码一次通过。
