Git入门指南：从安装配置到日常命令的完整实战手册

我不姓奶奶，但在这个行业里待得久了，办公室的小孩儿都这么喊我。这些年我带过的新人少说也有几十个，大家刚接触写代码时，绕不开的就是同一个坎：Git。Git这个词听起来很神，其实就是一套管代码的工具。你写的每一份代码、每一次修改、每一个想退回的节点，它都能帮你记住、帮你找回、帮你合并。这篇文章专门写给所有刚开始摸代码、被Git折腾得想摔鼠标的朋友，我会用教自家孩子的方式，把Git安装、基本配置、常用命令和常见报错一点点讲清楚，保证你跟着做就能上手。

1. 为什么连"奶奶"都需要学Git？——先搞懂代码管理这件事

1.1 Git到底是什么，它帮你解决什么问题

很多人第一次听见Git，是在面试题里，或者是同事的嘴里蹦出来的。它有个学名叫"版本控制系统"，这词儿听着唬人，其实特别接地气。你写平时交的论文，是不是习惯存好几个版本：初稿、修改稿、最终稿、打死不改稿？写到第三版又觉得第二版某段更好，只能翻箱倒柜找旧文件。Git就是给这种场景配的助理，你每次修改代码，跟它说一声"记一下"，它就把当时所有文件的内容整个快照存下来。以后你想回退到任意一次"记一下"的时间点，一条命令的事。

它最实用的三个场景：

• 防丢：电脑出故障、文件误删、手滑覆盖都不怕，因为Git本地和远程都有历史版本。
• 允许反悔：代码改崩了可以干净地回到上一个正常状态，不用一遍遍按撤销键。
• 多人协作：几个人同时改同一个项目，Git会记录谁在什么时间改了哪里，最后把大家的修改合并到一起。

我见过不少新手，刚写了几天代码就把整个项目弄没了，急得眼圈通红。其实只要从第一天就养成用Git的习惯，这种崩溃基本不会发生。

1.2 先分清三样东西：Git、GitHub、命令行

好多新人把这三样混在一起，问的问题经常是"我Git打不开网站怎么办"。这里花两分钟理清楚。Git是一个装在你自己电脑上的免费软件，它主要负责本地干活，不联网也能记录版本。GitHub是一个网站，可以理解为替你保存代码的远程仓库，把本地代码备份到云端，也方便团队协作，类似的还有GitLab和Gitee。命令行是你的对话窗口，在Windows上叫PowerShell或cmd，在macOS上叫终端，你在这个窗口里敲以git开头的命令，Git就帮你执行操作。

用大白话说就是：Git是你家里的记事本，GitHub是银行保险柜，命令行是你们之间的通话电话。你要做的事情，就是在命令行里用Git命令，把本地写好的代码推送到GitHub这个"保险柜"里存好。搞清这个关系再往下走，脑袋里就有一张地图了。

1.3 装之前先查一下：电脑里是不是已经有Git

很多电脑其实自带Git，不用重复安装。先打开命令行，Windows用户按Win+R，输入cmd回车，macOS用户在启动台里搜索"终端"打开。然后敲：

git --version

如果屏幕出现类似 git version 2.39.2 的字样，说明电脑里已经有Git了，直接跳到第二节去配置就行。如果提示 "'git' 不是内部或外部命令" 或者 "command not found: git"，那就是没装好或者没有加入环境变量，跟着下面的步骤动手装。

2. Git的安装与配置：一步步来，别慌

2.1 Windows安装：全程下一步，但三个选项要留意

Windows用户装Git，最省心的方式是打开Git官方网站（git-scm.com），点Downloads下载Windows版本，然后双击安装包。安装界面虽然是英文的，但不需要每个字都看懂，大部分页面直接点Next。

有三处需要稍微留心：

• 第一处是安装路径，默认在C盘就好，别手痒去改，省得给自己找麻烦。
• 第二处是Adjusting your PATH environment这一步，务必保持默认选项 Git from the command line and also from 3rd-party software。如果选成了只从Git Bash里用，后面你在cmd里敲git，系统会提示找不到命令，非常坑。
• 第三处是换行符设置，英文叫Line Ending Conversions，默认的Checkout Windows-style, commit Unix-style line endings就是最合适的。听着绕口，意思是代码从仓库里拿下来时转成Windows格式，提交回仓库时再统一成Linux风格格式，这样能最大程度减少团队协作时的换行符闹剧。

其余页面一路Next，装完之后重新开一个命令行窗口，再敲 git --version 验证一下，能看到版本号就说明装好了。

2.2 macOS和Linux用户怎么装

macOS装Git，我比较推荐先装Homebrew这个包管理器，然后一条命令搞定：

brew install git

如果不想折腾Homebrew，也可以去Git官网下macOS版本，像装普通软件一样双击安装。还有部分macOS系统自带Git，虽然版本可能偏老，但对新手学习完全够用。

Linux用户得看发行版。Debian/Ubuntu系列用：

sudo apt update sudo apt install git -y

CentOS/RHEL/Fedora系列用：

sudo yum install git -y

装完统一用 git --version 确认。看到版本号就说明安装这关过了。

2.3 装完立刻要做的三件事：用户名、邮箱、换行符

不少人都卡在这一步：Git装好了，高高兴兴去提交，结果系统甩来一句 Author identity unknown。这是因为Git需要知道"你是谁"，才会在每次提交上盖你的名字戳。这个配置在命令行里执行，加 --global 表示全局生效，只需要做一次：

git config --global user.name "你的昵称" git config --global user.email "你的邮箱@example.com"

两点提醒。第一，邮箱建议填写你注册GitHub或Gitee这类托管平台时用的那个，这样你的提交记录能正确关联到账号头像上，看着专业。第二，Windows用户顺手执行：

git config --global core.autocrlf true

macOS/Linux用户执行：

git config --global core.autocrlf input

这行命令的作用就是前面安装时提到的换行符处理，装的时候保留默认，这里再复核一遍更保险。用 git config --list 可以查看所有已配置项，确认没有漏东西。到这一步，Git就在你的电脑里安好家了，接下来正经用起来。

3. 第一次上手：Git的三板斧（add、commit、push）

3.1 从零初始化仓库：git init 做了什么

先找一个练习用的文件夹，比如D盘的 learn-git，在里面新建一个文本文件 hello.txt，写上"你好，Git"。然后在这个文件夹里打开命令行（Windows可以在文件夹地址栏输入cmd后回车，macOS可以在访达的文件夹里打开终端），输入：

git init

回车后Git会提示 Initialized empty Git repository。这时候你去看文件夹，可能会发现多了一个 .git 目录，如果看不到，需要在文件资源管理器里开启"显示隐藏文件"选项。这个 .git 目录就是Git的账本，里面记录着这个项目所有版本变化。以后在这个文件夹里执行的每条git命令，都在围绕这个账本工作。

关于 git init 有个常被忽略的注意点：一个项目只要初始化一次。千万不要在项目里的子文件夹又执行一遍 git init，那样会搞出嵌套仓库，一堆命令在里面很容易走错路。新手阶段记住一句话：一个项目，一个仓库。

3.2 把文件交给Git：git add 和 git commit

初始化之后，你的 hello.txt 还在账本外面。要让它被Git管理，得走两步。

第一步，把文件放进暂存区：

git add hello.txt

如果想把这个文件夹里所有变动都加进来，可以用：

git add .

第二步，把暂存区的内容正式提交为一条记录：

git commit -m "第一次提交，添加你好文件"

commit后面的 -m 是message的意思，引号里写这次提交的说明。这一步非常关键，很多人图省事写个"111"或者"aaa"，将来翻改历史的时候完全看不懂当时在干嘛，后患无穷。

提交成功会看到一段提示，类似 1 file changed, 1 insertion(+)，意思是本次提交涉及1个文件、增加了1行内容。这时候再执行 git status，会显示 working tree clean，意为工作区干干净净，所有改动都已记录在案。

为了真正建立手感，我建议你立刻做三遍练习：改 hello.txt 的内容，再 git add，再 git commit -m "第二次修改"，连续改动三次后执行 git log --oneline，会看到三条提交记录整齐排队。这个"记录感"一旦出来了，你就明白Git的价值了。

3.3 关联远程仓库并推送：git remote 与 git push

本地账本记好了，但只有一份，电脑坏了照样全没。所以要把它推到远程托管平台，常见的有GitHub、GitLab、Gitee。以GitHub为例，你先在网站注册账号并新建一个仓库（Repository），建的时候有两点需要注意：第一，仓库名最好不要有中文和空格；第二，新建时先别急着勾选Add a README file，否则远程会多一次初始提交，新手在后面推送时容易被冲突报错吓到。

拿到远程仓库地址（形如 https://github.com/用户名/仓库名.git）后，在本地命令行执行：

git remote add origin https://github.com/用户名/仓库名.git

这行命令的意思是给远程仓库起个小名 origin，之后用它代替一长串网址。接着推送：

git push -u origin main

-u 参数表示把本地main分支和远程main分支关联起来，以后在同一分支上直接敲 git push 就够了。推送过程中可能会要求登录GitHub账号，按提示在浏览器里完成授权即可。看到类似 main -> main 的输出，刷新一下GitHub页面，你的代码已经躺在远程仓库里了。

补充说明一下分支名。老版本Git的默认分支叫master，新版本很多叫main，二者本质上一样只是名字不同。你用 git init 初始化出来的仓库，默认分支如果是main，就推 main；如果显示是master，就写 git push -u origin master，和远程分支对上就行。

4. 日常用得最多的Git命令：备好这份"小抄"

4.1 状态查看三兄弟：status、log、diff

学Git最怕不知道自己处于什么状态。所以奶奶先教你三个查状态的命令。

git status 是最常用的，用来查看工作区当前状态，哪些文件改了、哪些还没add、哪些已经放进暂存区，都会用文字明确告诉你。很多新人看见一堆英文就慌，其实只需要抓几个关键词：Changes not staged for commit表示有改动但还没add；Changes to be committed表示已经add但还没commit；nothing to commit表示一切正常。看见第三个就能安心下班。

git log 查看提交历史，强烈建议加上 --oneline 参数，每条提交压成一行来看：

git log --oneline

你会看到类似下面的输出：

3f2a9d1 第二次修改 b8c7e12 第一次提交

左边那串字母数字是每条提交的唯一ID，今后想回退版本，靠它认路。

git diff 用来查看具体改了什么。写代码写到一半突然忘了改动细节，执行 git diff 会精确显示每一行的增删情况。注意，git diff 默认只比较工作区跟暂存区的差异，如果已经执行过 git add，还想看暂存区跟上次提交的差异，就要用 git diff --cached。

4.2 分支操作：branch、switch、merge

分支是Git最强大也最容易劝退新手的功能。我用高速公路来打比方：main分支是主干道，你想开发一个登录功能，担心搞砸整条路，就在旁边修一条匝道，也就是新分支，在匝道上随便折腾。试验成功了，把匝道接回主干道，这叫合并；试验失败了，把匝道直接铲掉，主干道毫发无损。

常用命令：

# 查看当前所有分支 git branch # 新建分支并切换过去 git checkout -b feature/login # 切回主干道 git checkout main

新版Git更推荐用 git switch 来切分支，语义更清晰，不容易和撤销操作混淆：

git switch -c feature/login git switch main

合并分支时，先切到要合并到的目标分支，比如main，再执行：

git merge feature/login

Git会把 feature/login 分支上的所有提交合并到main里。如果两个分支改了同一个文件的同一处地方，合并过程可能出现冲突，解决办法在第五部分展开讲。这里先记住命令本身，别贪多。

4.3 撤销与回滚：restore、reset、revert怎么选

撤销操作是新手问得最多的，也是最容易搞混的地方，我直接用一张表给你说清。

其中 git reset 有三个常见参数需要单独解释：--soft 只是把HEAD指针挪回去，改动内容还留在暂存区；--mixed 是默认值，把改动从暂存区挪回工作区；--hard 会把所有改动都扔掉，是最强也最危险的操作。新手如果只是后悔了想重来，优先用 git restore，别一上来就碰 reset --hard。等以后对Git理解深了，再按需要选择。

对于已经推送到远程的提交，我强烈建议用 git revert 而不是 git reset，因为revert不会改写项目历史，它相当于在原有提交后面追加一条"反着做一遍"的提交，协作时不至于把队友的历史搞乱。

5. 常见问题与排查技巧实录

5.1 我遇到的几个典型"翻车"现场

新手学Git，几乎人人都会碰见下面几个场景。我把应对方法直接写出来，你遇到时对照操作就行。

第一个：第一次 push 被拒绝。报错往往是 ! [rejected] main -> main (fetch first)。原因通常是远程仓库里有本地没有的提交，比如你建仓库时勾了README，远程就多出一条初始提交。解决办法是先把远程内容拉下来合并：

git pull --rebase origin main

然后再 git push，一般就能通过。注意这里的 --rebase 参数，它的作用是把本地新提交"接到"远程提交后面，让历史线保持整洁，比直接 git pull 少产生一个多余的合并提交。

第二个：作者身份没配置。执行 git commit 时报 Author identity unknown。解决办法就是回第二节，把 user.name 和 user.email 配好。很多人配过依然报错，多半是命令拼错成 user.nickname，或漏了 --global，用 git config --list 检查一下就能看到问题。

第三个：Windows上文件没改却显示modified。这种问题十有八九是换行符没配置对。Windows的换行符是回车加换行，Linux和macOS只有换行，Git比较内容时两边不一样，就误判成改动。解决方案是执行 git config --global core.autocrlf true，然后 git add . 再 git commit -m "fix line endings" 把当前状态固化成一次提交，后续就正常了。

第四个：合并冲突冒出满屏的 <<<<<<< 和 >>>>>>>。遇到这个不要慌。打开冲突文件，会看到两部分内容用 <<<<<<< HEAD ======= >>>>>>> 分支名 分隔。<<<<<<< HEAD 和 ======= 之间是当前分支的内容，======= 和 >>>>>>> 之间是对方分支的改动。你手工决定保留哪边，或者两边都留，删掉所有冲突标记，保存文件，然后 git add 这个文件，再 git commit -m "合并分支" 完成合并。注意冲突一次没解决完之前，别急着推远程，先在本地确认代码能跑。

第五个：改崩了想恢复。只要这个文件之前提交过，恢复文件到最近一次提交的状态是件很容易的事：

git restore 文件名

或者老一点的语法 git checkout -- 文件名，效果一样。已经提交过的内容，在Git里基本丢不了，这句话就是你大胆动手的底气。

5.2 新手最容易踩的坑清单

把多年带新人的经验浓缩成一份避坑清单，建议你存到备忘录里：

• 提交信息不要写"111""aaa""123"这类无意义内容，过三个月你自己都看不懂。
• git add . 之前先 git status 看清楚要提交的东西，别把编译产物、临时目录、日志文件带进去。
• 涉及密码、密钥、令牌的文件绝对不要提交，更别推到远程。正确做法是在项目根目录创建 .gitignore 文件，把这类文件路径写进去。
• push 失败时，千万克制住用 git push -f 强推的冲动。强推会用本地历史覆盖远程历史，多人协作时属于爆炸级操作。
• 拉取远程更新，优先用 git pull --rebase，而不是直接 git pull，这样提交历史更好读，冲突也更容易处理。

6. 奶奶的私房经验：让Git真正成为你的好帮手

6.1 提交节奏：别憋大招，要小步快跑

我经常看到有人写了一大堆代码才想起来"提交一下"，这等于把Git用成了存档工具。Git真正的用法是"小步提交"：每完成一个小的逻辑步骤就commit一次，哪怕只是改了一个函数的参数名，或者修了一个单词的拼写。这样做最直接的好处是，某一步改崩了，回滚到最近正常点的成本极低；排查bug时，git log也能精准定位是哪次提交引入了问题。我自己带技术团队时反复强调一条：代码是长出来的，不是憋出来的，提交也一样。

6.2 提交信息怎么写，才算没白写

好的提交信息，应该让三个月后的你一眼就明白当时做了什么。我常用一个简单模板：类型加内容。比如 fix: 修复登录功能在火狐浏览器下的报错，feat: 新增用户头像上传功能，refactor: 抽取数据库连接工具类。先写类型，再写具体内容，一目了然。没有硬性规定必须用这套格式，但至少要做到过几个月回头看，不用打开代码也知道这次提交干了什么。这也是一种工作素养，进了团队别人看你的提交记录，印象分一下就上去了。

6.3 从今天开始，用Git管理你手头的所有项目

哪怕你现在只是写作业、做课程设计、练手抄代码，我也建议从今天起就用Git。原因非常实在：第一，尽早养成肌肉记忆，等真正进了团队协作，不会手忙脚乱；第二，你的作品需要一个靠谱的备份地方，别再把文件夹从"最终版"改到"打死不改版"了；第三，未来面试时聊到版本管理经验，这是实打实的加分项。养成习惯的方式也很简单：动手写代码前先 git init，写完一小块就 add 和 commit，当天结束时把内容 push 到远程，这三分钟真不该省。

说到底，Git并没有多高深，它就是把"后悔药"和"保险箱"合二为一的工具。我用了这么多年Git，最深的体会是：版本管理的核心不是命令背得多熟，而是习惯养得多好。命令忘了随时查一下就会，但那种"代码永远改不坏、随时可以重来"的踏实感，只有真正持续用Git的人才能体会到。孩子，别怕敲错命令，Git没那么容易把你的代码弄丢，放心大胆试吧。