接触Git这么多年,从最早用SVN时期的各种不情愿,到现在团队协作完全离不开它,我算是把Git从安装到日常使用的各种坑都踩了一遍。这篇文章不打算写成官方文档那种干巴巴的说明书,而是想以我实际工作中的使用经验为主线,把Git版本控制系统的核心概念、安装配置、常用命令、提交规范,以及那些新手最容易卡住的报错问题,一次性讲清楚。不管你是刚接触编程准备学习代码管理,还是已经用了一段时间但总被各种git命令和分支搞得晕头转向,这篇内容应该都能帮你少走不少弯路。
我见过太多人把Git当成一个单纯的"代码存档工具",每天就是add、commit、push三连,一旦遇到合并冲突、提交错了、需要回滚版本这类情况就手足无措。说到底,Git不只是一个工具,它更像是一套团队协作的"规则体系"。你越早理解它的设计思路,后面用起来就越顺手。
1. Git是什么,先把它和GitHub、GitLab区分开
1.1 三个名字,别搞混
很多刚入门的朋友会把Git和GitHub当成同一个东西,其实差距挺大的。Git是一个版本控制系统,它是一个安装在本地电脑上的命令行工具,负责追踪你代码文件的每一次修改历史。而GitHub、GitLab、Gitee这些是基于Git的远程代码托管平台,相当于把Git仓库放到云端服务器上,方便多人协作、代码审查、问题追踪。
打个比方,Git就像是你本地的一份"文件修改日记",每一次改动都记录在案。而GitHub/GitLab是"公共档案馆",你把日记副本传到档案馆里,同事才能看到你的改动并协同办公。没有Git,GitHub就只是个普通网盘;没有GitHub这类平台,Git也发挥不了多人协作的价值,这两者是相辅相成的关系。
1.2 为什么Git能"打败"SVN等传统版本控制
在我早期工作时,团队用的是SVN(集中式版本控制系统)。SVN的模式是"中央仓库"——所有代码都集中存放在一台服务器上,每个人从服务器拉取最新代码,改完再提交回去。这种模式有个很大问题:一旦服务器挂了或者网络不通,你连提交代码都做不到,更别说查看历史记录了。
而Git采用的是分布式架构。每个人本地克隆仓库时,拿到的不只是最新代码,而是完整的版本历史。也就是说,哪怕远程服务器彻底瘫痪,你本地依然可以正常提交、查看历史、创建分支,等服务器恢复后再把代码推上去。这个设计在当时简直是降维打击,也是Git能在短短几年内取代SVN成为主流版本控制系统的根本原因。
另外,Git对**分支(branch)**的支持也远胜SVN。在SVN里创建分支就是复制一份目录到服务器,又慢又占空间。在Git里创建分支只是创建一个指针,几乎瞬间完成。这就让"功能分支开发"这种协作模式变得极其轻量,也成为现代软件开发流程(如Git Flow、GitHub Flow)的基础。
1.3 Git的三个区:工作区、暂存区、版本库
这是理解Git最关键的模型,很多命令搞不懂都是因为没吃透这个模型。
- 工作区(Working Directory):就是你电脑上能看到的项目文件夹,你改代码就是改这里的文件。
- 暂存区(Staging Area / Index):一个临时存放区域,用
git add命令把工作区的改动放到这里,相当于准备提交的"候车区"。 - 版本库(Repository / .git目录):Git真正保存历史版本的地方,用
git commit把暂存区内容固化成一个版本记录。
这个三段式设计是Git区别于很多其他版本控制系统的核心特色。为什么中间要隔一层暂存区?因为不是所有改动都想一次性提交。比如你在一个文件里同时修了Bug和新写了功能,可以先git add部分内容提交一次,再修改后提交第二次,这样历史记录更清晰,回滚时也更精准。如果是SVN那种"改完直接提交",就没法做到这种精细控制了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装与初始配置:准备工作做不好,后面全是坑
2.1 Windows/Mac/Linux下的安装方式
不同操作系统安装Git的方法差异很大,我分别说下最常用的方式。
Windows系统:最直接的方法是去Git官网下载安装包(git-scm.com),下载后一路Next安装。但这里有几个选项需要特别注意:
- 选择默认编辑器:建议选VS Code或者Nano,如果你选了Vim,新手在提交时误入Vim界面会完全不知道如何退出(后面我会专门讲这个坑)。
- 调整PATH环境变量:一定要选"Git from the command line and also from 3rd-party software",这样Git才能被命令行和VS Code、小乌龟等图形工具正常识别。
- 行尾转换(Line Ending Conversions):新手建议选"Checkout as-is, commit as-is",也就是不做任何换行符转换,避免在不同系统协作时出现一堆莫名其妙的文件变动。
Mac系统:如果你装了Homebrew,一条命令搞定:brew install git。否则可以去官网下载安装包。Mac自带Git,但版本通常比较老,建议还是装新版。
Linux系统:Debian/Ubuntu系用sudo apt install git,CentOS/RHEL系用sudo yum install git。
装完验证是否成功,在终端输入git --version,能输出版本号说明安装成功。这一步看起来简单,但很多人在这一步就卡住了,我在第4章会详细讲"git不是内部或外部命令"的解决方法。
2.2 首次配置:设置用户名和邮箱
Git安装完后的第一件事不是创建仓库,而是告诉Git你是谁。因为每一次git commit都会记录你的身份信息,这个信息会永远留在历史记录里。
bash复制git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
--global参数表示全局配置,对所有仓库生效。如果你只想给当前仓库单独设置身份(比如工作项目用公司邮箱,个人项目用私人邮箱),进入仓库目录后去掉`--gl
