安装基础命令行环境
很多刚接触Mac开发的朋友在终端里敲下git命令时经常报错，核心原因多半是基础配置没做对。Git本身是Unix系统内置的版本控制工具，但在macOS上需要手动激活并完成身份绑定。首先打开终端应用程序，直接输入xcode-select --install并回车。系统会自动弹出下载窗口，点击安装等待进度条走完。如果终端提示已安装或版本较新，可以直接跳过此步。这一步完成后，输入git --version就能看到具体的版本号，说明基础环境已经就绪。值得注意的是，不要随意下载第三方安装包来替代官方命令行工具，保持原生环境能最大限度减少依赖冲突。
绑定开发者身份信息
Git每次提交代码都需要记录作者身份，否则会出现警告或者无法推送。在终端依次输入两行命令：git config --global user.name "你的真实姓名" 和 git config --global user.email "你的注册邮箱"。注意引号内的内容一定要替换成你在GitHub或Gitee等平台注册的真实信息。配置完成后，可以通过git config --list查看是否生效。这里特别提醒，邮箱务必填写常用且能正常接收通知的地址，因为代码托管平台会通过它绑定账号权限和发送安全提醒。全局配置只会生效一次，后续新建的仓库都会自动继承这些设置，无需重复填写。
生成并配置SSH免密通道
每次推送代码都要输入账号密码非常繁琐，使用密钥对是最稳妥的解决方案。在终端执行ssh-keygen -t ed25519 -C "你的邮箱"。连续三次回车即可，分别确认保存路径、设置密码短语和确认密码短语。如果不习惯设密码，直接留空回车就行。生成成功后，终端会显示一串指纹字符，这是公钥的标准位置。接着输入cat ~/.ssh/id_ed25519.pub复制整段内容。打开对应代码托管平台的账户设置页面，找到SSH Keys选项，新建一条记录，把粘贴板里的内容完整贴上去，起个容易识别的设备名称保存。这样本地终端就拥有了远程服务器的通行凭证，彻底告别手动输密码。
建立本地与远程仓库的连接
进入项目文件夹后，先执行git init完成本地仓库初始化。然后添加远程仓库地址，命令是git remote add origin ssh链接。这个链接去代码平台的项目主页复制，通常以git@开头。如果之前已经建过连接，可以用git remote remove origin清理旧配置再重新添加。关联完毕后，执行git branch -M main把当前分支统一命名为主干分支。这能避免和平台默认的master分支产生冲突，现在主流开源项目和团队协作基本都改用main作为主分支。完成这两步后，本地目录下的.git文件夹会多出一个config文件，里面记录了当前的连接映射关系。
验证连通性与日常维护技巧
所有配置做完后，不要急着写入大量代码，先跑一次连通性测试。输入ssh -T git@github.com（如果是码云则换成git@gitee.com），平台会询问是否继续连接，输入yes并回车。看到Welcome字样就说明通道完全打通了。之后每次拉取最新代码用git pull，推送本地修改用git push。如果遇到权限拒绝或连接超时，大概率是系统钥匙串缓存了旧凭证，可以在系统设置里的钥匙串应用中找到对应的网络条目删除，下次交互会重新触发认证流程。日常开发中建议定期运行git status查看工作区状态，养成小步提交的习惯，配合这套配置流程，后续克隆项目、创建分支、合并代码都能顺畅运行，完全不用担心环境差异导致的工作流中断。
