1. 项目概述为什么Mac终端与Git是开发者的黄金搭档如果你是一名在Mac上进行开发的程序员那么“终端”和“Git”这两个词对你来说就像空气和水一样不可或缺。Mac的终端Terminal或iTerm2提供了一个强大而纯粹的Unix命令行环境而Git则是现代软件开发的基石负责管理代码的每一次心跳。将两者结合意味着你拥有了从本地开发到云端协作的完整控制力。这篇文章不是一份冰冷的命令手册而是我作为一个长期在Mac上使用Git的开发者对日常工作中那些高频、核心且容易踩坑的命令的一次系统性梳理和深度解读。无论你是刚接触Git的新手还是想优化自己工作流的老手这里的内容都能让你在终端里操作Git时更加得心应手避开那些我当年踩过的“坑”。我们会从最基础的配置讲起一直深入到提升效率的高级技巧目标是让你手中的命令每一条都知其然更知其所以然。2. Git环境配置与初始化打造顺手的开发环境在开始敲命令之前一个正确且个性化的Git环境是高效工作的前提。很多问题都源于最初配置的疏忽。2.1 安装与验证确保Git就位虽然macOS通常预装了Git但版本可能较旧。我建议通过Homebrew安装或更新到最新版本以获得更好的性能和安全性修复。# 使用Homebrew安装Git如果尚未安装Homebrew请先访问brew.sh安装 brew install git # 安装后验证安装及版本 git --version注意如果你在安装后运行git --version显示的仍然是旧版本可能是因为系统默认的PATH环境变量优先指向了/usr/bin/git。你可以通过which git命令查看当前使用的是哪个Git。Homebrew安装的Git通常在/usr/local/bin/git。确保你的终端配置文件如~/.zshrc或~/.bash_profile中/usr/local/bin的路径在/usr/bin之前。2.2 基础身份配置你的代码“身份证”这是使用Git的第一步也是最重要的一步。你提交的每一次代码都会带着这个身份信息。# 设置全局用户名和邮箱--global表示对所有仓库生效 git config --global user.name “你的姓名” git config --global user.email “你的邮箱example.com” # 检查配置是否生效 git config --global --list实操心得这里的邮箱强烈建议使用你在代码托管平台如GitHub、GitLab注册时使用的邮箱。这样你的提交才能正确关联到你的平台账户展示头像和贡献图。对于公司项目你可能会需要为特定仓库设置不同的身份这时可以进入项目目录使用不带--global的命令进行局部配置。2.3 提升体验的实用配置一些简单的配置能极大改善日常使用体验我强烈推荐你设置它们。# 设置默认分支名为 main更现代的命名 git config --global init.defaultBranch main # 为命令设置别名简化输入例如用 co 代替 checkout git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.st status git config --global alias.unstage ‘reset HEAD --’ git config --global alias.last ‘log -1 HEAD’ # 快速查看最后一次提交 # 开启命令自动补全如果你用的是zsh通常homebrew安装时会自动链接 # 对于bash你可能需要手动source /usr/local/etc/bash_completion.d/git-completion.bash # 设置默认的文本编辑器为VS Code替换为你喜欢的编辑器 git config --global core.editor “code --wait”为什么是code --wait这个参数告诉Git在编辑器关闭之前请等待。这样当你执行git commit而不带-m信息时Git会打开VS Code让你编写提交信息并且只有在你在VS Code中保存并关闭文件后Git才会继续完成提交操作。如果不用--waitGit会瞬间完成提交因为你编辑器还没打开提交信息是空的。3. 仓库操作与日常开发流从零到提交掌握了环境配置我们就可以开始真正的代码之旅了。这部分涵盖了从创建仓库到日常提交的完整闭环。3.1 仓库的创建与克隆一切始于一个仓库Repository。# 1. 本地初始化一个新仓库 mkdir my-project cd my-project git init # 这会在当前目录创建一个隐藏的 .git 文件夹它是Git的“数据库”。 # 2. 克隆一个已存在的远程仓库最常用 git clone 远程仓库URL # 例如git clone https://github.com/username/repo.git # 这会在当前目录创建一个以仓库名命名的文件夹并自动将远程仓库地址命名为 origin。克隆的两种常见协议HTTPShttps://github.com/...。通用性强但每次推送可能需要输入密码或使用凭证助手。SSHgitgithub.com:username/repo.git。需要预先配置SSH密钥但配置好后无需每次输入密码更安全便捷。我个人更推荐使用SSH。3.2 状态查看与文件管理洞悉工作区git status是你最应该频繁使用的命令它告诉你当前工作区和暂存区发生了什么。# 查看详细状态 git status # 查看更简洁的状态我常用的别名是 git st如果你配置了的话 git status -s # 输出可能是 # ?? newfile.txt (未跟踪的新文件) # A addedfile.txt (已添加到暂存区的新文件) # M modifiedfile.js (已修改的文件) # MM file.py (左边M表示工作区有修改右边M表示暂存区也有修改内容不同)文件生命周期管理# 将工作区的修改添加到暂存区Stage git add 文件名 # 添加特定文件 git add . # 添加当前目录所有变化常用但需谨慎 git add -u # 添加所有已跟踪文件的修改和删除不包含新增文件 # 从暂存区移除文件但保留工作区的修改 git reset HEAD 文件名 # 放弃工作区对某个文件的修改危险不可恢复 git checkout -- 文件名 # 移除文件同时从工作区和Git仓库中删除 git rm 文件名 # 仅从Git仓库中删除保留工作区文件常用于误提交了敏感文件后 git rm --cached 文件名注意事项git add .是一把双刃剑。它非常方便但可能会不小心添加了编译产物如node_modules/,*.log、本地配置文件或敏感信息如密钥文件。务必在操作前用git status确认一遍或者更好的是创建一个.gitignore文件来永久排除这些文件。3.3 提交更改为代码变化打上“快照”暂存区的更改需要通过提交Commit来永久记录。# 提交暂存区的更改并附带提交信息 git commit -m “清晰的提交信息” # 修改上一次提交的信息前提是还没推送到远程 git commit --amend -m “新的提交信息” # 或者如果你想将工作区新的修改也并入上一次提交 git add . # 添加新的修改到暂存区 git commit --amend --no-edit # 合并修改不改变提交信息如何写好提交信息这是体现专业性的地方。第一行是简短的摘要不超过50字符空一行后是详细的描述。摘要使用祈使句如“Fix login bug”而非“Fixed login bug”。描述部分说明“为什么”要这么改而不是“改了啥”代码本身能看出来。3.4 查看历史与差异时光回溯当需要回顾或理解代码的演变时这些命令至关重要。# 查看提交历史最常用 git log git log --oneline # 简洁的单行显示 git log --graph --oneline --all # 图形化显示所有分支历史非常直观 git log -p 文件名 # 查看某个文件的详细修改历史 # 查看工作区与暂存区的差异 git diff # 查看暂存区与最新提交的差异 git diff --staged (或 --cached) # 查看两次提交之间的差异 git diff commit-id-1 commit-id-2实操心得我几乎为git log --graph --oneline --all设置了一个别名git graph。它能一目了然地展示分支的合并、分叉情况在解决复杂分支历史时是救命稻草。4. 分支与协作并行开发的基石分支是Git的“杀手级”功能它让你能安全地尝试新功能或修复bug而不影响主线。4.1 分支基础操作# 查看所有分支当前分支前有 * 号 git branch git branch -a # 查看包括远程跟踪分支在内的所有分支 # 创建新分支 git branch 新分支名 # 切换分支 git checkout 分支名 # 或者使用更现代的 switch 命令语义更清晰 git switch 分支名 # 创建并切换到新分支一步到位最常用 git checkout -b 新分支名 git switch -c 新分支名 # switch 命令的对应写法 # 删除已合并的分支通常在功能合并后清理 git branch -d 分支名 # 强制删除未合并的分支谨慎使用 git branch -D 分支名4.2 合并与变基整合代码的两种哲学这是Git协作中最核心也最容易出问题的部分。合并Merge保留完整的历史记录创建一个新的“合并提交”。# 假设你在 feature 分支上开发完毕想合并到 main 分支 git switch main # 切换到主分支 git merge feature # 将 feature 分支合并进来合并会产生一个分叉的历史清晰地记录了分支的独立存在和汇合点。变基Rebase将当前分支的提交“重新播放”在目标分支的最新提交之后形成一条直线历史。# 在 feature 分支上操作 git switch feature git rebase main # 这会将 feature 分支的基底从原来的 main 提交点移动到当前 main 分支的最新提交点。 # 变基后可能需要解决冲突。完成后回到 main 分支进行一次快进合并即可。 git switch main git merge feature # 此时会是快进合并Fast-forward选择 Merge 还是 RebaseMerge更简单、安全保留了真实的历史。适用于公共分支如main,develop之间的合并或当你希望明确看到分支生命周期的历史时。Rebase创造更整洁的线性历史便于阅读。黄金法则只对你本地尚未推送的提交进行变基。绝对不要对已经推送到远程仓库的提交进行变基因为这会重写历史给其他协作者带来灾难。4.3 远程协作与团队同步本地开发最终需要与团队共享。# 查看远程仓库信息 git remote -v # 从远程仓库拉取更新Fetch Merge git pull origin main # 更推荐的做法是先拉取Fetch再合并Merge这样更可控 git fetch origin # 将远程所有更新下载到本地但不合并 git merge origin/main # 将远程 main 分支合并到当前分支 # 将本地提交推送到远程仓库 git push origin 本地分支名 # 首次推送时建立追踪关系 git push -u origin 本地分支名 # -u 是 --set-upstream 的简写 # 删除远程分支 git push origin --delete 远程分支名常见问题当你执行git push时如果远程已有你本地没有的新提交会被拒绝。这时你需要先执行git pull拉取并合并远程的更新可能会遇到合并冲突需要解决然后再推送。5. 高级技巧与问题排查从熟练到精通掌握了基本命令后这些高级技巧能帮你处理更复杂的场景并快速定位问题。5.1 暂存与恢复灵活切换上下文当你正在一个分支上工作突然需要去修复一个紧急bug时这个功能无比实用。# 暂存当前工作区和暂存区的所有修改 git stash git stash save “描述信息” # 带描述的暂存 # 查看所有暂存列表 git stash list # 恢复最近一次的暂存并从列表中删除它 git stash pop # 恢复某次暂存如 stash{1}但不删除 git stash apply stash{1} # 删除某个暂存 git stash drop stash{0} # 清空所有暂存 git stash clear5.2 撤销与重置时光机的正确用法Git允许你“后悔”但需要谨慎操作。# 场景1撤销上一次提交但保留所有更改在工作区相当于提交没发生过 git reset --soft HEAD~1 # 场景2撤销上一次提交并且取消暂存区的更改但保留工作区的修改 git reset HEAD~1 # 默认是 --mixed # 场景3彻底撤销上一次提交工作区的修改也丢弃危险 git reset --hard HEAD~1 # 场景4撤销某个特定的提交生成一个新的反向提交更安全适用于已推送的提交 git revert commit-id重要警告git reset --hard会永久丢弃未提交的更改和提交记录。除非你百分百确定否则慎用。对于已推送到远程的提交优先使用git revert。5.3 冲突解决协作中的必经之路当两个人修改了同一文件的同一区域时合并或变基就会产生冲突。识别冲突执行git merge或git pull后Git会提示CONFLICT。运行git status会显示Unmerged paths。查看冲突文件打开冲突文件你会看到类似这样的标记 HEAD 这是你当前分支的代码 这是要合并进来的分支的代码 branch-name手动解决与相关同事沟通决定保留哪一部分或者进行整合。删除,,这些标记保留最终想要的代码。标记已解决解决完所有冲突文件后使用git add 文件名将文件标记为冲突已解决。完成操作最后执行git commit来完成合并提交。实操心得使用图形化工具如VS Code内置的Git工具、SourceTree来解决冲突对于复杂冲突或新手来说比在终端里肉眼比对要直观和高效得多。5.4 查找与定位大海捞针# 根据提交信息搜索提交 git log --grep“关键词” # 在代码中搜索所有历史版本中包含特定字符串的提交 git log -p --all -S “函数名或字符串” # 查找引入某个bug的提交二分查找 git bisect start git bisect bad HEAD # 当前版本是坏的 git bisect good 已知的好版本的commit-id # Git会自动切到一个中间版本你测试后告诉它是好是坏 git bisect good # 或 git bisect bad # ... 重复直到Git定位到第一个坏提交 git bisect reset # 结束二分查找6. 打造高效的终端Git工作流最后分享一些让我在Mac终端下效率倍增的实践它们不仅仅是命令更是一种工作习惯。6.1 强大的终端工具与提示iTerm2 Oh My Zsh这是Mac终端环境的“黄金组合”。iTerm2比原生终端强大太多而Oh My Zsh提供了丰富的主题和插件。其中git插件尤其有用它会在你的命令行提示符中显示当前所在的分支名和仓库状态如是否有未提交的修改一目了然。配置别名Alias如前所述将长命令缩短。我的~/.gitconfig里还有更多[alias] lg log --color --graph --prettyformat:‘%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)%an%Creset’ --abbrev-commit cleanup “!git branch --merged | grep -v ‘\\*\\|main\\|master\\|develop’ | xargs -n 1 git branch -d” # 删除所有已合并到当前分支的特性分支git lg能输出一个非常漂亮的彩色图形化日志。6.2 思维模型与最佳实践提交原子化一次提交只做一件事。修复一个bug就提交一次添加一个功能就提交一次。避免“大杂烩”式的提交这样回滚、查看历史、代码审查都会清晰得多。勤提交勤推送在本地频繁提交保存你的工作进度。完成一个完整的功能模块后及时推送到远程备份和分享。本地提交成本极低不要等到写了几百行代码才想起来提交。拉取前先暂存在切换分支或拉取远程更新前如果工作区不干净先git stash暂存起来。这能避免不必要的冲突和混乱。理解工作区、暂存区、仓库这是Git的核心概念。工作区是你看到的文件暂存区Index是准备提交的“购物车”仓库是最终的“数据库”。add是把东西放进购物车commit是结账。6.3 当命令失效时如何自救即使经验丰富也难免遇到问题。记住这个排查思路git status是你的第一反应任何时候不确定状况先看状态。它能告诉你90%的问题。善用git helpgit help 命令会打开该命令的官方手册比网上搜的碎片信息更准确。理解错误信息Git的错误信息通常很直白。例如fatal: not a git repository就是不在Git仓库里error: failed to push some refs通常是远程有更新你没拉取。谨慎使用“核武器”reset --hard,push --force这类命令威力巨大使用前务必确认影响范围特别是涉及团队协作时。Git的学习曲线前期可能有些陡峭但一旦你熟悉了它的工作模式就会深深体会到它带来的秩序和力量。它不仅仅是一个工具更是一种管理思维和工作习惯。希望这份结合了命令与经验的梳理能成为你在Mac终端下驾驭Git的得力助手。记住最好的学习方式就是在实际项目中不断使用和犯错每一个你解决的问题都会让你对它的理解更深一层。