命令敲下去git status一刷满屏红色文件名。很多第一次接触 Git 的人都会蒙圈明明只是改了两行代码为什么要面对工作区、暂存区、HEAD、origin 这一堆概念我当年也是这样但用到现在我可以很负责任地说Git 是程序员最值得早点系统学一遍的工具没有之一。这篇教程不打算讲枯燥的历史直接从安装配置、常用命令、远程协作到疑难杂症按我实际摸爬滚打的路径完整走一遍你照着操作就能上手。1. 先搞懂Git到底能干什么1.1 没有版本控制的日常是什么样的你有没有经历过这种场景项目文件夹里躺着一堆“最终版”“最终版2”“真最终版”“打死也不改了版”的压缩包改个需求要小心翼翼复制一份再做生怕把原来能跑的版本搞坏。等到产品经理说“还是回到昨天那个样式吧”你只能翻遍聊天记录、解压十几个压缩包挨个启动看效果。更尴尬的是两个人同时改同一个文件最后合并时根本没有工具帮你对比差异只能靠肉眼一行行找。这些问题Git 都能解决。它帮你记录每次改动的快照哪一天、谁、改了什么、为什么改全部有痕迹。改坏了随时回滚多人并行开发也不会互相踩踏。说白了Git 就是代码界的“存档系统”而且是能开分支、能合并、能协作的高级存档系统。1.2 统一版本历史和分布式的差别用过 SVN 的朋友应该知道集中式版本控制的痛点所有操作都得连服务器离线就提交不了代码服务器一挂历史记录也可能跟着没。Git 属于分布式版本控制每个开发者 clone 下来的仓库都是一份完整的历史副本。本地提交不需要联网服务器挂了也不影响你继续写代码、继续提交等恢复了再推上去就行。还有一点非常核心Git 的分支操作极其轻量。SVN 建分支要复制整个目录慢且占空间Git 建分支只是创建一个指针秒级完成。所以很多团队现在把“分支开发”玩成了日常每个功能开个分支开发者各自在分支上折腾最后合并到主干。这种工作流没有 Git 之前很难想象。1.3 学Git前先建立四个概念如果你一上来就背命令很容易忘。我建议先建四个心智模型工作区你电脑里能看到的项目目录就是日常写代码的地方。暂存区一个临时存放区把想提交的文件先“放进去”相当于提交前的检查台。本地仓库git commit之后快照就永久落在本地仓库相当于本地档案柜。远程仓库GitHub、Gitee、GitLab 上那个服务端仓库相当于公司档案库大家共享。这四个概念记不住后面命令就老觉得玄学。记住一句话工作区 → 暂存区 → 本地仓库 → 远程仓库每一步对应不同的命令后面就好理解了。2. 安装与环境配置Windows 下的一站式方案2.1 Git for Windows 安装与镜像选择Windows 下最常规的安装包叫 Git for Windows官方地址是 git-scm.com。如果官网下载速度实在太慢可以找国内镜像站点比如腾讯软件源、淘宝 npmmirror 里的 Git 安装包版本同步也比较及时。安装过程基本都是“Next 到底”但有几个选项我建议你注意Select Components默认勾选即可建议把 “Git Bash Here” 和 “Git GUI Here” 保留右键菜单用起来很方便。Default editor如果没有特别偏好选 Notepad 或 VS Code 都行别选 Vim不然以后git commit弹出 Vim 你都不知道怎么退出。Adjusting your PATH environment务必选第二项“Git from the command line and also from 3rd-party software”。选了这一项安装完成后在 CMD、PowerShell 里都能直接用git命令。Line ending conversions一般保持默认Checkout Windows-style, commit Unix-style line endings跨平台协作时能避免很多莫名其妙的换行符问题。安装完之后打开命令行输入git --version如果输出了类似git version 2.47.1.windows.1的版本号就说明装好了。注意装完环境变量要重新打开终端窗口才会刷新。如果你在旧窗口执行git提示找不到命令先关掉重开别急着重装。2.2 要不要装 TortoiseGit 这个“小乌龟”很多 Windows 老玩家习惯用 TortoiseGit也就是常说的“小乌龟”。它最大的特点是集成到鼠标右键菜单文件夹里能看到文件的状态图标提交、拉取、更新都靠右键完成对命令行有恐惧感的人来说非常友好。我的建议是新手上路可以把 TortoiseGit 作为辅助工具但一定不要因此逃避命令。理由很简单绝大多数文档、教程、CI/CD 脚本、服务器操作还是以命令行为主你迟早要面对黑窗口。小乌龟适合快速看图、快速提交真正排查问题还得靠命令行。下载 TortoiseGit 时注意位数64 位系统装 64 位版本语言包单独下载安装后可以在设置里切换中文。它本身不包含 Git 核心所以需要先装 Git for Windows 再装小乌龟。2.3 全局配置用户名、邮箱、换行符Git 安装完成后第一件事不是急着建仓库而是告诉它你是谁。每个提交记录都会带上提交人的用户名和邮箱这两个信息不配置提交时会直接报错。git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com--global表示全局生效这台机器上所有仓库默认都用这个身份。如果想给某个仓库单独设置去掉--global在该仓库目录下执行即可。还可以顺手做几个小配置# 默认分支名改为 main适应现在的主流习惯 git config --global init.defaultBranch main # 提交时自动处理换行符Windows 用户强烈建议 git config --global core.autocrlf true查看当前所有配置用git config --list2.4 配置 GitHub / Gitee 免密登录SSH Key每次 push、pull 都要输用户名密码输三次你就烦了。解决办法是配 SSH Key配一次就能免密操作。先在本地生成密钥对ssh-keygen -t ed25519 -C 你的邮箱example.com一路回车就行默认保存在C:\Users\你的用户名\.ssh\id_ed25519。生成完用记事本打开.pub文件把里面内容完整复制。接下来登录你的 Gitee 或 GitHub进入设置 → SSH 公钥把内容粘贴进去保存。最后验证一下ssh -T gitgitee.com如果是 Gitee会提示你“Hi XXX! Youve successfully authenticated”说明配置成功。GitHub 就换成ssh -T gitgithub.com。2.5 让 Git 命令更好用的几个小配置用久了你会发现有些命令太长每次敲很烦。Git 支持配置别名我常用的几个git config --global alias.st status git config --global alias.co checkout git config --global alias.br branch git config --global alias.lg log --oneline --graph --all --decorate配置完之后git st等于git statusgit lg可以看分支图非常直观。还有个小技巧如果你觉得终端里显示的中文文件名是转义后的八进制码可以关掉路径转义git config --global core.quotepath false这个选项对国内开发者特别有用不然文件名含中文时git status里显示的是\344\270\255\346\226\207这种乱码看着头大。3. 常用 Git 命令从提交到回滚的完整闭环3.1 初始化仓库与第一次提交两种方式进入 Git 项目一种是在已有目录里初始化git init另一种是从远程克隆git clone。本地初始化后开始第一次提交流程# 查看当前仓库状态 git status # 把所有改动加入暂存区 git add . # 提交并写提交信息 git commit -m 初始化项目 # 查看提交历史 git log --oneline建议不要一上来就git add .无脑全加。先把git status当成习惯看清楚哪些文件被修改了再决定要不要全部提交。我见过太多人把密钥文件、构建产物、IDE 配置一股脑提交进去后悔都来不及。3.2 文件状态、暂存与撤销git status里你会发现文件状态分好几种未跟踪、已修改、已暂存、无变化。可以用git status -s看简洁版两列状态提示左边是暂存区状态右边是工作区状态。只提交部分文件时用git add 文件名逐个添加想撤销暂存用git restore --staged 文件名仅撤销工作区的改动、恢复到最近一次提交的版本git restore 文件名如果你有临时改动不想形成正式提交可以塞进暂存垃圾桶后面再取出来git stash # 把当前改动暂存起来 git stash list # 查看暂存列表 git stash pop # 恢复最近一次暂存3.3 分支操作与合并冲突处理分支是 Git 的灵魂。创建一个自己的分支git branch feature-login # 创建分支 git switch feature-login # 切换分支 git switch -c feature-login # 创建并切换一步到位切回主分支用git switch main老一点的命令是git checkout main两者现在都支持。切分支时注意工作区有未提交改动会跟着你“跑”如果不想带过去先 commit 或 stash。合并分支时如果两个分支改动了同一个文件同一行就会产生冲突。冲突文件里会出现这样的标记 HEAD 这是主分支的代码 这是功能分支的代码 feature-login处理方法是手动保留你想要的版本把三行标记删掉然后git add 冲突文件 git commit -m 合并分支并解决冲突这里要提醒一句解决冲突时不要只看自己改的那一段要结合上下文理解两个分支的意图。我踩过一次坑合并时保留错了逻辑导致上线后一个优惠活动把价格算成了负数。3.4 回滚三兄弟reset、restore、revert代码改崩了要回滚先分清用哪个命令这很重要。git restore只动工作区或暂存区把单个文件恢复成某个版本。git reset把当前分支的 HEAD 指针往后退可以同时影响暂存区和工作区。常用参数--soft只移动 HEAD所有改动还留在暂存区。--mixed默认移动 HEAD改动回到工作区。--hard改动全部丢弃不可找回要非常慎重。git revert不删除历史而是生成一个“反向提交”。比如提交 A 加了一行代码git revert A就生成一个新提交把这行删掉。已经 push 到远程的提交绝对不要用 reset 重写历史否则别人会拉不下来代码。正确做法是用git revert生成反向修复再把新提交推上去。git revert 提交ID3.5 标签与发布版本给版本打标签相当于在历史记录上贴一个醒目的标签。比如发了个 v1.0.0以后想回看这个版本直接切标签就行。git tag v1.0.0 git tag -a v1.0.0 -m 发布1.0.0版本 git tag -l标签默认不会自动推到远程需要显式推送git push origin v1.0.0 # 或者一次推送所有标签 git push origin --tags4. 远程仓库协作从 clone 到 pull request4.1 本地仓库与远程仓库关联初始化好的本地仓库要跟远程仓库建立关联。在 GitHub 或 Gitee 上新建一个仓库复制 SSH 地址然后git remote add origin gitgitee.com:你的用户名/仓库名.git git remote -vorigin只是默认的远程仓库别名你可以改成任意名字。如果 clone 下来的项目origin 已经自动配好不用重复添加。4.2 push / pull 的正确打开方式新手最容易踩的坑就是改完代码直接git push结果报错“远端有本地没有的提交”。原因很简单远程被别人推了新代码你的本地历史已经和远程分叉了。正确的流程是git pull --rebase # 先把远程更新拉到本地基于远程最新代码重放本地提交 git push # 再推送--rebase能让提交记录更线性不容易出现“merge commit 满天飞”的情况。如果觉得 rebase 概念不好理解刚开始直接git pull也行就是会产生一个额外的合并提交。记住一条原则push 之前先看别人有没有更新别闷头推。pull其实等于fetch merge。fetch只是把远程更新拉下来不改动工作区之后你可以用git log origin/main查看远程状态merge才是把远程分支合并进当前分支。想精细控制就用fetch再决定怎么办。4.3 代码评审与合并请求流程现在很多团队走的是分支开发 合并请求Pull Request / Merge Request流程你开一个功能分支推送到远程然后在 Gitee 或 GitHub 上发起合并请求让同事评审代码评审通过后再合并进主分支。这样做的价值不只是流程正规更重要的是“让代码在合并前多一双眼睛检查”。实际执行时注意别把一堆无关改动塞进一个合并请求里每个 MR/PR 尽量只干一件事。Review 的时候不能只看 diff 本身还要考虑兼容性、命名、异常处理。4.4 .gitignore 忽略文件该写什么每个 Git 仓库都应该有.gitignore告诉你哪些文件不能被 Git 追踪。常见的要忽略依赖目录node_modules/、vendor/构建产物dist/、build/、target/IDE 配置.idea/、.vscode/系统文件.DS_Store、Thumbs.db环境变量与密钥.env、*.pem要忽略某个已经被提交的文件怎么办先把它从 Git 索引移除再添加忽略规则git rm --cached 文件名 echo 文件名 .gitignore4.5 提交信息规范代码写得好不好看提交信息就知道。普通团队至少做到“提交信息说清楚改了什么”规范一点的团队会按 Angular 规范走type(scope): subject feat: 新增功能 fix: 修复 bug docs: 文档变更 style: 格式调整 refactor: 重构 test: 测试 chore: 杂项举个例子git commit -m fix(order): 修复优惠券金额计算为负数的问题好的提交信息能在排查历史时帮你节省大量时间。我的习惯是提交信息里永远说“为什么改”而不只是“改了什么”。5. 常见问题与疑难杂症速查5.1 Windows 提示“git 不是内部命令”怎么处理“git : 无法将‘git’项识别为 cmdlet、函数、脚本文件或可运行程序的名称”——这个报错几乎每天都有新手遇到。原因只有一个系统 PATH 环境变量里没有 Git 的安装目录。处理方法分两步先找到 Git 安装路径默认是C:\Program Files\Git\cmd。打开系统环境变量设置在Path里新增这个路径保存后重开终端。如果找不到安装路径在开始菜单搜索“Git Bash”打开后运行which git输出结果复制里面的路径填进环境变量就行。还有一种情况是安装时 PATH 选项选错了重新运行安装程序把 PATH 改为第二项即可修复。5.2 GitLab 登录失败login failed. check api token or gitlab version如果你在 IDE 或某些 Git 图形工具里拉取 GitLab 仓库突然报这个错大概率是以下原因之一访问令牌过期GitLab 出于安全限制很多私有仓库要求用 Personal Access Token 代替密码token 过期就需要在 GitLab 设置里重新生成。服务端版本太旧一些新版本的 IDE 插件调用 GitLab API 的方式和老版本 GitLab 不兼容。报错信息中有 “check api token or gitlab version”就是提示你去核查这两点。解决办法是先在浏览器里正常登录 GitLab到用户设置里新建一个带read_repository、write_repository权限的 token然后用用户名加 token 的方式重新认证。如果用的是 IDEA还可以检查一下是否安装了过旧的 GitLab 插件更新之后这个报错通常会消失。5.3 Git 目录泄露是怎么回事“git目录泄露如何下载”这个热词经常出现在安全相关的搜索里。它指的是一个网站把整个 Git 仓库部署到了 Web 服务器可以直接访问的目录下访问者通过http://域名/.git/就能把仓库里的历史记录、源码配置甚至密钥下载下来。这属于典型的服务端安全配置失误。正确做法是不要把.git目录暴露在 Web 根路径下部署时只发布构建产物或指定目录。在 Nginx 等 Web 服务器里显式禁止访问.git目录location ~ /\.git { deny all; }如果你是开发者也要留意自己项目在公网上是否可以被外界访问到.git路径。用浏览器或 curl 访问一下你的域名/.git/config如果能看到内容就必须马上处理。5.4 VSCode 集成 Git 的使用VSCode 内置 Git 支持不需要装插件就能用。打开项目后左侧“源代码管理”图标会显示修改文件数量。提交、推送、拉取、分支切换都可以在界面上完成新手友好度很高。但有些时候你会在 VSCode 终端看到背后执行的命令git -c diff.mnemonicprefixfalse -c core.quotepathfalse --no-optional-locks status这行命令看起来很吓人其实只是 VSCode 在调用 Git 时加了一些实用参数--no-optional-locks表示执行状态查询时不获取可选锁避免因为状态刷新影响正在进行的仓库操作core.quotepathfalse就是前面说的中文文件名显示优化。了解这个之后遇到类似命令就不用慌了。5.5 Git 常用命令速查表这里给一份我日常使用频率最高的命令速查表建议收藏场景命令说明配置git config --global user.name name设置全局用户名初始化git init在当前目录创建仓库克隆git clone url从远程复制仓库状态git status查看工作区状态暂存git add file添加文件到暂存区提交git commit -m msg提交暂存区快照历史git log --oneline查看简洁提交记录分支git branch -a查看所有分支切换git switch branch切换分支合并git merge branch合并指定分支到当前分支拉取git pull --rebase拉取远程并变基推送git push推送本地提交到远程暂存git stash临时保存当前改动回滚git revert commit生成反向提交标签git tag v1.0.0打标签5.6 几个容易“社死”的低级错误最后讲几个我亲眼见过、自己也踩过的低级错误把数据库连接密码提交到公开仓库就算后边删掉提交历史里可能还留着要彻底清除得重写历史。正确做法是任何密钥都不入 Git统一走环境变量。在错误分支上改了代码发现切不了分支是因为有改动未提交我的处理是先git stash切到正确分支再git stash pop。合并冲突时乱删别人的代码这种事最容易被同事吐槽。解决冲突前先跑一下测试再看看上下文别为了“赶紧合上去”而丢掉功能。用 --hard 回滚后懊悔不已git reset --hard会丢弃工作区改动如果之前没有 commit 也没有 stash基本找不回来。所以操作前一定要git branch留个备份分支或者先git stash。我在实际项目里用 Git 这么多年最深的体会是命令本身并不难难的是建立“版本管理”的思维习惯。你不需要把所有参数背下来但一定要理解状态流转、知道每个操作会留下什么痕迹、会对远端产生什么影响。另外再多分享一个我的习惯每次开始一天工作前先git pull一次结束时确认今天的改动已提交并推送。这样哪怕电脑硬盘突然坏了代码也不会丢。Git 这个东西越早用、用得越狠后面受益越大。希望这篇教程能让你少走一点弯路赶紧去把项目里那些“最终版.zip”删了吧。