又到了季度答辩季,我连续帮几个团队的同事过了遍代码仓库,发现一个挺普遍的现象:大部分人都能把Git“用起来”,clone、add、commit、push这四板斧比谁都熟,可一旦遇到分支错乱、代码丢失、push被拒这类稍微绕一点的情况,就只能靠搜索临时抱佛脚。Git这名字听起来简单,实际上它已经是几乎所有研发团队的协作底座,理解它和机械地背命令,工作体验完全是两回事。
这篇文章想聊的,不是把Git官方文档再翻译一遍,而是从我这些年的实际踩坑和带人经验里,整理出一套关于Git的完整打法:从装好环境、日常提交,到多人协作、撤销恢复,再到典型的报错排查链路。无论你是刚装好Git还不知道怎么配的新人,还是已经写了几年代码但总觉得对Git心里没底的同学,都可以按图索骥。
1. 从一个崩溃现场聊聊为什么要认真学Git
1.1 我理解的Git本质:不是备份工具,而是时间旅行器
先讲一个我自己经历过的故事。刚工作的头一年,我在feature分支上写了一下午代码,临时要切回main分支查一个线上问题,顺手就切过去了,结果再切回feature分支的时候发现写的东西全没了。当时我冷汗都下来了,赶紧问同事,才知道原来代码只是落在工作区没提交,切分支时被“藏”起来了,用git stash或者切分支前先commit就能避免。这件小事让我意识到:Git的核心设计从来不是“把代码存起来”,而是“记录每一次变更,并允许你在不同时间线之间穿梭”。
Git把仓库分为三个区域:工作区(你正在编辑的文件)、暂存区(通过git add选中的变更)、本地仓库(通过git commit固化的一次次快照)。加上远程仓库,就构成了完整的四层流转。理解这个模型后,再去理解reset、checkout、revert这些命令的区别会容易得多——它们本质上都是在调整不同区域之间的状态。
1.2 这篇内容适合谁,能帮你解决什么
先说适合的读者。第一种是刚接触Git,下载完安装包之后不知道下一步干吗的新手;第二种是已经用了两三年,能完成日常开发,但遇到分支错乱、冲突、误删除就发怵的同学;第三种是想给团队做内部分享或制定规范的人。
这篇文章不会把Git命令按A-Z完整罗列,而是按真实的工作流组织:先讲环境准备和身份配置,再讲日常提交的高频操作,然后进入多人协作的分支与冲突管理,接着是撤销与恢复这类“后悔药”,最后用真实案例复盘几个最常见的报错排查链路。每一节都会解释“为什么这么做”,而不只是扔给你一串命令。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备:从零装好Git并跑通第一个仓库
2.1 各平台安装Git的方式与避坑点
Windows用户建议直接到Git官网下载安装包,选择对应系统的64位版本。安装过程中最需要注意三个选项,很多教程一带而过,但选错后面会非常难受。
第一个是调整PATH的选项,要选“Git from the command line and also from 3rd-party software”。如果你漏选了,在CMD或PowerShell里敲git会提示找不到命令,只能在Git Bash里用,非常憋屈。
第二个是默认编辑器,默认是Vim。对不熟Vim的人来说,某次commit时不小心进了vim界面,整个人就卡住了——按i进入插入模式,输入提交信息后按Esc,再输入:wq回车才能退出。如果你装了VS Code,建议顺手选成VS Code,能省掉很多不必要的困扰。
第三个是关于行尾换行符(Line Ending)的转换策略。多人在不同操作系统之间协作时,Windows用CRLF,macOS和Linux用LF,处理不好会看到大量“整个文件被修改”的假diff。Git官方给出的建议是:Windows下checkout时转为CRLF、提交时转回LF,macOS/Linux选择checkout as-is / commit as-is。
macOS系统自带Git,可以直接在终端里用git --version确认。不过自带版本通常偏旧,我建议通过Homebrew安装新版本:
bash复制brew install git
Linux用户更简单,Debian/Ubuntu系用apt install git,CentOS/RHEL系用yum install git或dnf install git。
2.2 装完以后第一件事:配置身份信息与默认值
很多新手装完Git第一件事是急着建仓库,结果提交后发现commit记录里的作者名是一串系统生成的字符,邮箱也不对。这些信息会永久写入提交历史,后期虽然可以改写,但一旦推送到远程、多人拉取过,改起来非常麻烦。
装完Git之后,请立刻执行以下配置:
bash复制git config --global user.name "你的姓名"
git config --global user.email "你的邮箱"
git config --global init.defaultBranch main
git config --global pull.rebase false
我简单解释一下每条的意义。user.name和user.email会写入每一次commit的元数据,代码评审和问题追溯全靠它。init.defaultBranch main把git init创建的默认分支名从老旧的master改成main,避免新建仓库后在推送时还要手动改分支名。pull.rebase false是让git pull默认采用merge方式而非rebase,对于多数团队来说,merge方式产生的结果更直观,出问题的概率更低。
这里有个很多人不知道的细节:git config的作用范围分为system、global、local三层。global是当前用户全局生效,local是当前仓库内生效,优先级是local高于global。比如公司项目里需要提交到公司代码库的邮箱,个人开源项目用另一个邮箱,就可以在对应仓库目录里单独执行`git conf
