1. 项目概述为什么Mac终端与Git是开发者的黄金搭档如果你是一名在Mac上进行开发的程序员那么终端和Git绝对是你绕不开的两大核心工具。它们一个是你与操作系统深度对话的窗口另一个则是你管理代码生命线的版本控制系统。我见过不少新手开发者面对黑乎乎的终端窗口和一堆看似晦涩的Git命令感到畏惧转而依赖图形化界面工具。这当然没问题但当你需要处理更复杂的仓库操作、编写自动化脚本或者在服务器上工作时命令行的高效与强大是无可替代的。掌握Mac终端下的Git常用命令本质上是在提升你作为开发者的“硬核”操作能力它能让你对代码的掌控力从“会用”升级到“精通”。这篇文章的目的就是为你梳理出一份在Mac终端环境下从安装配置到日常高频使用的Git命令实战指南。它不是一份冰冷的命令手册而是融合了我多年在团队协作、开源项目以及个人开发中积累下来的实操经验和避坑心得。无论你是刚刚接触Git的新手还是想系统梳理命令、提升效率的老手这份“持续更新”的清单都能成为你手边可靠的参考。我们将从最基础的环境搭建讲起覆盖代码提交、分支管理、远程协作、历史追溯等全流程并重点解释每个命令背后的逻辑和常见的使用场景让你不仅知道怎么敲更明白为什么这么敲。2. Git环境在Mac上的搭建与基础配置在开始挥舞Git命令之前我们需要确保“武器”已经就位且称手。Mac系统虽然预装了Git但版本可能较旧。一个更新、更稳定的Git环境是高效工作的基础。2.1 安装与升级Git首先打开你的终端Terminal可以通过Spotlight搜索Command 空格输入Terminal快速启动。输入以下命令检查当前Git版本git --version如果系统提示“command not found: git”说明没有安装如果版本号较低比如低于2.x建议升级。主流安装/升级方法使用Homebrew推荐Homebrew是Mac上强大的包管理器。如果你还没有安装Homebrew可以访问其官网获取安装命令。安装好Homebrew后在终端中执行brew install git这将会安装最新稳定版的Git。如果要升级已通过Homebrew安装的Git使用brew upgrade git下载官方安装包你可以直接从Git官网下载适用于macOS的.pkg安装包图形化安装适合不熟悉命令行的用户。注意使用Homebrew管理Git的好处在于后续升级和管理依赖都非常方便。同时Homebrew会自动帮你处理好一些必要的依赖项。2.2 必不可少的初始配置安装好Git后第一件事不是急着创建仓库而是进行全局配置。这就像为你新买的笔记本贴上姓名标签并设定好书写习惯。最重要的两个配置是用户身份信息这将会记录在你每一次的提交历史中。git config --global user.name “你的姓名或昵称” git config --global user.email “你的邮箱地址”请务必使用你真实且常用的邮箱特别是未来需要参与GitHub、GitLab等平台协作时这个邮箱会关联你的账号和提交记录。其他实用全局配置设置默认文本编辑器当Git需要你输入提交信息如执行git commit而不加-m参数时会打开一个编辑器。默认为Vi/Vim对新手可能不友好。可以改为VS Code或系统自带的文本编辑工具。# 设置为VS Code git config --global core.editor “code --wait” # 设置为系统默认文本编辑TextEdit git config --global core.editor “open -t -W”启用终端颜色高亮让Git输出在终端中更具可读性。git config --global color.ui auto配置别名Alias这是大幅提升效率的秘诀可以为长命令设置简短的别名。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’配置后你就可以用git st代替git status用git co main代替git checkout main了。查看与编辑配置查看所有全局配置git config --global --list编辑全局配置文件通常位于~/.gitconfig可以直接用文本编辑器打开或者用git config --global -e命令。实操心得我强烈建议在配置别名时采用一套自己习惯的、与团队可能通用的缩写。这能让你在一天数十上百次的Git操作中节省大量时间。另外user.name和user.email一定要最先正确配置否则后续修改历史提交的作者信息会非常麻烦。3. 仓库操作与代码提交的核心流程拥有了称手的Git环境我们就可以开始真正的代码管理之旅了。这一部分涵盖了从创建/获取一个仓库到将本地修改安全地保存到历史记录中的完整闭环。3.1 初始化与克隆项目的起点一切始于一个Git仓库。你有两种方式获得它git init在本地创建一个全新的Git仓库。进入你的项目目录执行此命令Git会在当前目录下创建一个隐藏的.git文件夹用于跟踪管理所有版本信息。cd /path/to/your/project git init这之后你就可以开始添加文件并提交了。git clone这是更常见的场景——获取一份已存在的远程仓库如GitHub上的项目的完整副本。这个命令不仅复制文件还会自动将远程仓库地址命名为origin并拉取所有历史记录。git clone https://github.com/username/repository.git如果你想克隆到指定目录可以在后面加上目录名git clone https://github.com/username/repository.git my-local-folder3.2 状态查看与文件管理工作区的瞭望塔在做出任何提交之前你必须清楚当前工作区和暂存区Stage的状态。这是避免误操作的关键。git status这是你最应该频繁使用的命令。它能清晰地告诉你哪些文件被修改了但还未暂存Unstaged。哪些文件已暂存等待提交Staged。是否有新创建但未被跟踪的文件Untracked。当前所在的分支信息。 一个清晰的git status输出是你进行下一步操作的决策依据。git add将工作区的修改“挑选”到暂存区。暂存区是一个中间区域允许你精心组织一次提交中包含哪些更改。git add file.txt # 添加单个文件 git add src/ # 添加整个目录 git add . # 添加当前目录下所有更改包括新文件慎用 git add -p # 交互式暂存可以逐个检查每个修改块hunk并决定是否暂存极其有用git add -p是我极力推荐的高级技巧。它让你能拆分一次大的修改为多个逻辑清晰的提交保持提交历史的整洁。git restore与git reset用于撤销更改。git restore --staged file将已暂存Staged的文件撤销回未暂存状态Unstaged但保留工作区的修改内容。这是git add的反向操作。git restore file直接丢弃工作区中某个文件的修改恢复到最近一次提交的状态。危险操作谨慎使用git reset HEAD file旧版命令效果与git restore --staged类似。在配置了别名unstage后可以用git unstage file。3.3 提交变更凝固历史时刻当暂存区的内容准备好后就可以创建一个永久的快照——提交Commit。git commit -m “提交信息”最常用的提交方式。-m参数后跟的是本次提交的说明信息。提交信息至关重要应清晰、简洁地描述本次修改的目的例如“修复用户登录时密码验证失败的bug”而非简单的“更新代码”。git commit -m “feat: 新增用户个人中心页面”git commit不加-m参数Git会打开你配置的默认文本编辑器让你编写更详细的多行提交信息。第一行是简短摘要空一行后可以写详细描述。这对于复杂的提交非常有用。git commit -a -m “信息”-a参数可以跳过git add步骤自动将所有已跟踪tracked文件的修改暂存并提交。注意它不会包含新创建的未跟踪文件。这个命令方便但不够精确在需要精心组织提交时慎用。注意事项养成“小步快跑”的提交习惯。每次提交只完成一个小的、独立的功能或修复一个bug。避免将一大堆不相关的修改一次性提交。清晰的提交历史就像一本好的项目日志在未来回滚、排查问题或代码审查时价值连城。3.4 查看历史时光回溯机提交之后你需要有能力回顾过去。git log查看提交历史。默认按时间倒序排列显示提交哈希、作者、日期和提交信息。git log git log --oneline # 简洁的单行显示只显示哈希和提交信息摘要 git log -n 5 # 查看最近5条提交 git log --graph --oneline --all # 以图形化方式展示所有分支的合并历史非常直观我通常会给git log --graph --oneline --all设置一个别名如git graph用于快速查看分支拓扑图。git diff查看差异。git diff # 比较工作区和暂存区的差异 git diff --staged # 比较暂存区和最新提交HEAD的差异 git diff commit1_hash commit2_hash # 比较两次提交之间的差异 git diff branch1..branch2 # 比较两个分支最新提交的差异4. 分支管理并行开发的基石分支是Git的“杀手级”特性它让你能在不同的线上并行开发而不会相互干扰。4.1 分支的创建、切换与查看git branch列出所有本地分支。当前分支前会有一个*号标记。git branch branch_name基于当前提交创建一个新分支但不会自动切换过去。git checkout -b branch_name创建并立即切换到新分支。这是最常用的创建分支方式。git checkout -b feature/user-authentication良好的分支命名习惯很重要例如feature/xxx、bugfix/xxx、hotfix/xxx。git checkout branch_name或git switch branch_name切换到已存在的分支。git switch是较新版本Git引入的更语义化的命令专用于切换分支推荐使用。git branch -d branch_name删除一个已合并的分支。Git会检查该分支的修改是否已经合并到当前分支如果已合并则安全删除。git branch -D branch_name强制删除一个分支无论其是否合并。危险操作通常用于丢弃一个实验性的、失败的分支。4.2 合并与变基整合代码的两种哲学当分支上的开发完成后需要将其成果整合回主分支如main或master。主要有两种方式合并Merge和变基Rebase。git merge branch_name将指定分支的修改合并到当前分支。这会创建一个新的“合并提交”Merge Commit保留了两个分支的历史脉络。git checkout main git merge feature/user-authentication优点历史记录真实保留了分支的独立性。缺点如果分支很活跃历史图可能会变得复杂出现很多交叉线。git rebase branch_name变基。它相当于把当前分支的修改“挪动”到目标分支的最新提交之后使得历史呈现一条直线。git checkout feature/user-authentication git rebase main操作解读上面命令的意思是“假设我的feature分支是从main分支的某个旧点开始的现在我要把main分支上新的提交‘重播’到我的feature分支基础之下然后再把我的修改接上去。”优点历史记录简洁是一条干净的直线。缺点重写了提交历史如果分支是公共的已推送到远程会对其他协作者造成困扰。黄金法则只对尚未推送到远程的本地提交进行变基。对于公共分支永远使用合并。变基是一个强大的工具但用错了地方就是团队协作的灾难。在个人特性分支上为了保持与主分支同步并简化历史我经常使用git rebase main。4.3 合并冲突的解决无论是合并还是变基当Git无法自动协调两个分支对同一文件的同一部分的不同修改时就会产生冲突。终端会提示CONFLICT。解决流程Git会将冲突文件标记出来并用符号包围冲突内容。你需要用编辑器打开这些文件手动决定保留哪一部分的代码或者进行整合修改。删除冲突标记符。解决完所有冲突文件后使用git add .或git add file将解决后的文件标记为已解决。最后执行git commit来完成合并或变基操作变基时可能是git rebase --continue。# 合并时发生冲突解决后 git add . git commit # 变基时发生冲突解决后 git add . git rebase --continue # 如果想放弃本次合并或变基 git merge --abort git rebase --abort5. 远程协作连接世界的桥梁个人开发是基础团队协作才是常态。远程仓库如GitHub, GitLab, Gitee是代码共享和协作的中心。5.1 远程仓库的关联与管理git remote -v查看已关联的远程仓库列表及其URLfetch和push。git remote add origin remote_url为本地仓库添加一个远程仓库并命名为origin这是约定俗成的默认名称。git remote remove origin移除名为origin的远程仓库关联。5.2 推送与拉取同步的脉搏git push origin branch_name将本地指定分支的提交推送到远程仓库origin的同名分支。git push origin feature/user-authentication如果是第一次推送本地分支到远程可以使用-u参数建立追踪关系之后就可以简写为git push。git push -u origin feature/user-authentication # 后续在该分支上直接执行 git push 即可git pull origin branch_name从远程仓库origin拉取指定分支的最新修改并**合并merge**到当前分支。它相当于git fetch获取远程更新 git merge合并到本地两个操作的组合。git pull origin maingit fetch origin一个更安全的操作。它只会从远程仓库下载所有最新的提交和历史但不会自动合并到你的当前工作分支。这让你有机会在合并前先查看一下远程的变更情况。git fetch origin git log --oneline origin/main # 查看远程main分支的更新 git merge origin/main # 手动合并远程更新我个人的习惯是更多地使用git fetchgit merge或git rebase而不是直接git pull因为这样对合并过程有更强的控制力。5.3 跟踪分支与上游分支当你从远程克隆一个仓库或者使用git push -u后本地分支和远程分支就建立了跟踪关系。你可以通过git branch -vv查看跟踪状态。git pull和git push在不指定远程和分支时默认作用于当前分支跟踪的上游分支。6. 高级操作与问题排查实战掌握了基础命令你已经能应对90%的日常场景。剩下的10%则是一些能让你如虎添翼的高级技巧和救急方案。6.1 修改历史谨慎使用的“时间魔法”git commit --amend修改最近一次提交。如果你刚提交完发现漏了文件或者提交信息写错了可以用这个命令补救。git add forgotten_file.txt git commit --amend -m “新的提交信息”注意这会改变提交的哈希值如果该提交已经推送到远程强制推送git push --force会造成协作问题。git rebase -i HEAD~n交互式变基。可以修改最近n次提交的历史包括重新排序、合并squash、修改提交信息、删除提交等。这是一个非常强大的历史整理工具。git rebase -i HEAD~3 # 修改最近3次提交执行后会打开编辑器按照提示进行操作即可。同样只适用于未推送的提交。6.2 暂存与恢复工作现场当你正在一个分支上工作到一半突然需要切换到另一个分支处理紧急事务时git stash是你的救星。git stash或git stash push -m “描述信息”将当前工作区和暂存区的修改保存到一个临时堆栈中并将工作区恢复到干净状态最近一次提交的样子。git stash list查看所有的储藏列表。git stash apply stash{n}恢复指定的储藏n为列表编号如stash{0}是最新的但储藏内容不会从列表中删除。git stash pop stash{n}恢复并删除指定的储藏。git stash drop stash{n}删除指定的储藏。6.3 问题排查与状态恢复开发中难免手滑以下命令能帮你从各种“事故”中恢复。git reflog引用日志。它记录了HEAD和分支引用在本地仓库的所有移动历史如切换分支、提交、重置、合并等。这是Git里最强力的“后悔药”。即使你误删了分支或重置reset错了地方只要操作记录还在reflog里默认90天内你就能找到对应的提交哈希并恢复。git reflog # 找到误操作前的那个记录复制其哈希值如 abc1234 git checkout -b recovered-branch abc1234git reset重置当前分支的HEAD到指定状态有三种模式--soft仅重置HEAD指向不碰暂存区和工作区。所有更改都保留在暂存区。可用于重新组织提交。--mixed默认重置HEAD和暂存区但保留工作区的修改。这是撤销git add和提交的常用方式。--hard危险重置HEAD、暂存区和工作区。所有未提交的修改都将丢失使用前务必三思或确保有备份stash。git reset HEAD~1 # 撤销最近一次提交但保留修改到工作区--mixed git reset --hard origin/main # 强制将本地分支与远程main分支同步丢弃所有本地修改和提交git cherry-pick commit_hash精选提交。将另一个分支上的某一次或多次提交单独应用到当前分支。适用于将某个紧急修复从一个分支移植到另一个分支而不需要合并整个分支。git checkout main git cherry-pick abc1234 # 将哈希为abc1234的提交应用到main分支6.4 常见问题速查与解决下表整理了一些在Mac终端使用Git时常见的错误信息和解决方法问题现象可能原因解决方案fatal: not a git repository (or any of the parent directories)当前目录不在Git仓库内。使用cd命令切换到正确的项目目录或使用git init初始化新仓库。error: failed to push some refs to ‘...’本地分支落后于远程分支通常因为别人先推送了。先执行git pull拉取远程更新并解决可能的合并冲突然后再git push。Please tell me who you are.未配置全局用户信息。执行git config --global user.name “...”和git config --global user.email “...”。There is no tracking information for the current branch.当前分支没有设置上游跟踪分支。使用git push -u origin branch_name首次推送时建立跟踪或使用git branch --set-upstream-toorigin/branch_name手动设置。合并冲突CONFLICT两个分支修改了同一文件的同一区域。手动编辑冲突文件解决冲突后执行git add和git commit或git rebase --continue。git pull后终端进入奇怪编辑器Vim界面git pull触发了自动合并需要你输入合并提交信息。按i进入插入模式编写信息然后按ESC输入:wq保存退出。或配置默认编辑器为非Vim。想撤销git add操作误将文件添加到了暂存区。使用git restore --staged file或git reset HEAD file。想彻底丢弃工作区的修改代码改乱了想回到上次提交的状态。使用git restore file针对特定文件或git checkout -- .针对所有文件旧命令。此操作不可逆掌握这些命令和技巧你在Mac终端上使用Git将会游刃有余。记住最好的学习方式是实践。创建一个测试仓库大胆尝试各个命令观察git status和git log的变化很快你就能建立起直观的理解。随着使用的深入你会发现命令行提供的控制力和灵活性是任何图形化工具都难以完全替代的。