在macOS环境下进行代码管理，Git是最基础也最核心的工具。很多新手在安装和配置时容易踩坑，或者找不到系统性的操作指引。本指南直接聚焦mac终端操作，涵盖从环境搭建到日常提交的全流程，内容结构清晰，适合随时查阅或导出为pdf离线使用。
mac上安装git的三种主流方式
mac系统本身并不预装完整版git，但提供了完善的底层支持。第一种也是最推荐的方式是使用homebrew包管理器。打开终端后输入brew install git，系统会自动下载最新稳定版并配置好环境变量，全程只需回车确认。第二种是苹果官方提供的命令行工具。在终端执行xcode-select --install，会弹出软件更新提示，点击安装后就能获得git基础命令集，适合不想额外安装第三方工具的轻量用户。第三种是直接前往官网下载安装包，选择对应mac版本的pkg文件，双击按向导完成安装即可。无论选哪种，安装完成后在终端输入git --version，看到版本号即代表成功。
基础配置与身份绑定
拿到git后第一件事是设置开发者身份。全局配置用户名和邮箱的命令是git config --global user.name你的用户名和git config --global user.email邮箱地址，这些标识会出现在每次提交的记录里。mac系统自带钥匙串服务，建议开启凭据存储功能，执行git config --global credential.helper osxkeychain，以后推送代码到远程仓库就不用反复输入密码。如果习惯使用ssh密钥连接，可以用ssh-keygen -t ed25519 -C你的邮箱生成公钥，然后把公钥内容复制到github或gitee的后台设置中，实现免密拉取。
核心命令与工作流实战
日常开发中最常用的组合拳就是状态查看、暂存修改和提交记录。进入项目目录后输入git status，红色文字显示未跟踪文件，绿色文字显示已暂存待提交内容。用git add文件名将指定文件加入暂存区，或者用git add .一次性把所有改动打包。接着运行git commit -m提交说明文字，把快照固定下来。分支管理是多人协作的基础，git branch列出所有分支，git checkout切换分支，git branch新分支名创建独立开发线。合并代码时用git merge源分支名，冲突出现时手动打开文件解决标记，解决完重新add和commit即可。最后通过git push origin主分支名推送到云端仓库。
如何获取与保存pdf版本
为了方便离线学习和团队内部传阅，建议将此类技术文档整理成pdf格式。在mac浏览器中打开当前页面，按下command加p调出打印面板，在目标打印机下拉菜单中选择另存为pdf，调整边距和排版后点击保存即可生成标准电子手册。也可以利用终端的wkhtmltopdf工具或在线转换服务，把本地markdown笔记一键转成pdf，方便随时携带查阅。
高频问题快速排查
遇到fatal not a git repository提示，通常是因为当前路径不在版本控制目录下，cd切换到正确文件夹即可。权限被拒绝多发生在push阶段，检查远程仓库地址是否写错，或者确认ssh密钥是否已正确绑定。误删本地修改不用慌，git checkout --文件名能瞬间还原到上次提交的状态。如果需要清空整个工作区回退到干净状态，可以执行git reset --hard origin主分支，注意此操作不可逆，执行前务必确认备份重要数据。
掌握git不需要死记硬背所有参数，理解版本快照的核心逻辑比盲目敲命令更重要。配合mac终端的高亮自动补全功能，日常操作效率会大幅提升。建议初学者先在小项目中跑通一次完整流程，建立肌肉记忆后再接触高级特性如rebase和cherry-pick。保持提交粒度适中，写好说明文字，团队协作自然会顺畅许多。
