1. 先把环境收拾利索Git安装和终端环境1.1 各平台安装方式很多新人卡住的第一关不是命令不会敲而是Git根本没装好或者装完之后终端识别不到。热搜里那条“git : 无法将‘git’项识别为 cmdlet、函数、脚本文件或可运行程序的名称”特别有代表性——十有八九是环境变量PATH没配上。Windows平台推荐直接去Git官网下载安装包一路Next。安装时有两个选项值得留意默认编辑器建议选Visual Studio Code或Nano别留着Vim——你早晚会直接在Git里编辑提交信息Vim对新手太不友好。“Adjusting your PATH environment”这一步选第二项“Git from the command line and also from 3rd-party software”这样Git会被自动写入系统PATH后面在CMD或PowerShell里直接敲git就没问题了。装完顺手把Git Bash也放个快捷方式在任务栏。Git Bash是一个模拟Linux终端的环境比CMD和PowerShell更贴近Git生态很多老手哪怕在Windows上工作日常Git操作也全在Git Bash里完成。macOS用户如果有Homebrew一条 brew install git 搞定没有的话去官网下载pkg安装包。Linux这边Debian/Ubuntu系用 sudo apt install gitCentOS/RHEL系用 sudo yum install git。1.2 装完之后先验证一件事不管哪个平台装完之后第一时间打开终端敲三行命令验证环境git --version which git git config --list第一行看版本能输出版本号说明安装成功。第二行看Git安装路径确认终端用的是系统级还是用户级的Git——如果你Windows上装了多个版本这一步能帮你排查用错命令的问题。第三行是重点初始化情况下它可能什么都不返回或者只显示系统级的配置这是正常的。1.3 PATH配置现场急救如果你已经在官网装好了Git但cmd里敲git仍然报“无法识别”那基本就是PATH问题。处理方式很简单打开“设置 → 系统 → 关于 → 高级系统设置 → 环境变量”在系统变量里找到Path点“编辑”把Git安装目录下的cmd文件夹路径加进去默认是 C:\Program Files\Git\cmd。加完之后必须关掉当前终端重新开一个环境变量不会自动刷新到已打开的窗口里。这里有个小经验修改PATH后不要只关终端最好是注销一下Windows账户或重启一次Explorer尤其是你同时装了多个终端工具比如Windows Terminal、PowerShell、传统CMD的时候不同终端的PATH缓存刷新时机不一样。踩过太多次这种坑了。2. 入职第一天的标配动作身份配置与SSH公钥2.1 让Git知道你是谁Git提交代码时每一次commit都会记录作者信息。这个信息不是从你的系统账户自动读取的而是需要在Git里单独配置。入职新公司、换新电脑第一件事就是这个git config --global user.name 你的名字 git config --global user.email 你的邮箱用 --global 表示全局生效这台机器上所有仓库都会用这套身份。如果公司内部有不同账号体系比如个人项目和公司项目分属不同Git服务器可以在某个仓库目录下单独执行不带 --global 的同款命令这样该仓库会覆盖全局配置。配完之后验证一下git config user.name git config user.email这里要强调一个细节GitLab、GitHub、Gitee这类平台识别提交身份主要看提交邮箱。你配置的邮箱必须跟你账号绑定的邮箱一致否则你推上去的代码虽然能成功但提交记录会显示成“未知作者”或者归不到你的头像下面。有些公司对提交邮箱还有强制校验规则配错邮箱可能连push都会被服务器拒绝。2.2 SSH公钥免密拉代码的关键热搜词里有“git免密”“配置公钥私钥拉取代码全流程”“login failed. check api token or gitlab version”——这些都是同一个主题认证方式。Git拉取和提交代码最常用的两种认证方式是HTTPS和SSH。HTTPS方式最简单每次clone时输入账号密码或输入访问令牌token。以前GitHub支持密码直接push现在全部改成token了这就是热搜“idea中拉取git代码要token”的由来——不是配置出问题了是GitHub把密码认证下了。SSH方式则是一劳永逸。你生成一对密钥公钥放到Git平台的个人设置里私钥留在本地之后所有clone、pull、push都不需要再输任何凭证。生成密钥ssh-keygen -t ed25519 -C 你的邮箱一路回车即可默认生成路径是 ~/.ssh/id_ed25519 和 id_ed25519.pub。这里如果要求设置密码短语passphrase可以直接留空不然每次操作都要多输一次密码日常开发很烦躁。然后把公钥内容加到平台cat ~/.ssh/id_ed25519.pub复制输出打开GitHub的 Settings → SSH and GPG keys、GitLab的 Preferences → SSH Keys、或Gitee的 设置 → SSH公钥粘贴保存。验证连通性ssh -T gitgithub.com ssh -T gitgitlab.com ssh -T gitgitee.com看到 “Hi 用户名! Youve successfully authenticated” 一类提示就说明通了。2.3 密钥报错排查比较常见的坑是 ssh-rsa 被拒绝。老版本生成的RSA密钥在某些新平台策略下可能会报“no mutual signature algorithm”。如果你遇到这个手动指定密钥类型重新生成ssh-keygen -t ed25519 -C 你的邮箱 -f ~/.ssh/id_ed25519然后还有一个企业环境常见的问题公司内网禁止22端口外连SSH连不上。这时可以改用HTTPS 443端口连接GitHub前提是你在 ~/.ssh/config 里手动声明Host github.com Hostname ssh.github.com Port 443 User git实测下来这个方案在日常网络环境下很稳定。3. 拉取代码clone和pull要分清3.1 从零开始git clone拿到完整仓库你第一次接触一个项目要把远程仓库的完整代码复制到本地用的是 clonegit clone gitgithub.com:用户名/仓库名.git执行完之后当前目录下会出现一个和仓库同名的文件夹里面是完整的代码、完整历史记录以及.git目录——这才是Git的“本体”所有提交记录、分支信息、HEAD指针都在里面。clone时可以加参数控制要哪个分支git clone -b develop gitgithub.com:用户名/仓库名.git这适用于仓库默认分支不是你要的分支或你想直接切到某个feature分支的情况。如果你只想拉最近一次提交的历史不关心完整的提交记录加 --depth 1git clone --depth 1 gitgithub.com:用户名/仓库名.git这会把克隆时间从几分钟压到几秒大型仓库特别管用。代价是你失去完整历史git log 里只有最上面一条提交。后期如果需要的完整历史可以再 git fetch --unshallow 找回。3.2 日常同步git pull把远程新代码合进来clone只做一次之后的日常操作是 pullgit pull origin main这句话的意思是把远程分支 origin/main 的最新提交拉取到本地并且自动合并到你当前所在的分支。它等价于两条命令的组合git fetch origin git merge origin/main搞清楚这一点非常重要——pull不是单纯的“下载新代码”而是“下载合并”。如果本地有过修改而远程也更新了同一个文件pull就有可能触发冲突。所以我的建议是执行pull之前先运行 git status 看当前工作区是否干净。如果你有未提交的修改要么先提交要么先暂存git stash git pull git stash popstash命令把你的本地修改暂时存到一个“避难所”pull完合并成功后再把这些修改放回工作区。这是避免pull冲突最实用的一招。3.3 拉取失败与卡住的处理热搜里有“git拉取代码一直fetch see help gc for manual housekeeping”——这类报错提示你看对象库的垃圾回收情况。Git拉取时会在底层做对象计数、压缩、差异计算大型仓库这个阶段可能持续很久甚至会卡住不动。遇到这种情况先冷静等五分钟因为fetch大仓库对象确实慢。如果长时间无响应考虑以下操作先 CtrlC 中断不要慌fetch是幂等操作中断不会损坏仓库。执行 git gc --prunenow 手动做一次垃圾回收清理松散对象后再重新pull。检查网络。公司网络访问外网Git服务经常抽风可以用一个代理或镜像服务绕过去。另外HTTP/2协议在某些网络环境下会导致fetch假死。可以在仓库目录里临时关闭HTTP/2git config --global http.version HTTP/1.1改完再拉取类似“fetch卡住”“一直fetch”的状况大概率能解决。4. 提交代码一次规范提交的完整链路4.1 工作区、暂存区、本地仓库、远程仓库Git提交不是一步到位而是四层结构工作区Working Directory你打开编辑器正在编辑的目录。暂存区Staging Area / Index你准备纳入下次提交的文件清单相当于“待提交区”。本地仓库Local Repositorygit commit 之后改动被正式记录到本地历史但还没推出去。远程仓库Remote Repositorygit push 把本地历史推到服务器。很多新人搞不清这个流程以为改完代码直接push就能更新。实际上你必须先 add把文件加入暂存区再 commit把暂存区内容固化成提交记录最后 push把提交推送到远程。为什么要分成这么多步核心原因是让你可以选择性提交。比如你改了三个文件其中两个是关于新功能的一个是无意义的临时打印你可以只 add 前两个文件第三个留在工作区不提交。4.2 提交前先看状态与差异开工前和提交前必须先摸清现状git status git diffgit status 告诉你哪个文件被修改了、哪个文件是新增未跟踪、当前在哪个分支。git diff 告诉你改动前后的具体内容差异。提交前跑这两个命令能避免把调试用的临时代码提交上去。如果你想看暂存区和上一次提交之间的差异git diff --cached这是最容易被忽视的命令。你把文件 add 到暂存区之后再修改这个文件第二次修改不会自动进入暂存区——只有你明确 add 的那一版内容会被提交。git diff --cached 能帮你确认“我即将提交的到底是哪个版本的代码”。4.3 按规范提交feat、fix、docs这些前缀提交信息不是随便写的。主流做法是遵循 Conventional Commits约定式提交规范。热搜里的“feat fixed”就是这个意思——用类型前缀标注这次提交的性质类型含义示例feat新功能feat: 增加登录页面部二维码免密登录fix修复Bugfix: 修复列表页在低分辨率下样式错位docs文档变更docs: 更新README中的部署说明refactor重构不改变行为refactor: 抽取公共校验方法style代码格式调整style: 统一单双引号风格test测试相关test: 为订单模块补充单元测试chore构建、工具链等杂项chore: 升级webpack到5.x提交信息写得好不好直接影响后面看git log和做code review的效率。我的习惯是一条提交只做一件事信息格式用类型(可选范围): 简要描述。比如git commit -m fix: 修复支付回调验签失败的金额精度问题复杂提交建议用-m写标题、再写一段正文说明背景但日常开发一条建议描述多数场景都够用。4.4 推到远程git push与首次-u参数commit之后代码只存在于本地仓库。要分享给团队得pushgit push origin main首次推送新分支时加 -u 参数git push -u origin feature-login-u 是 --set-upstream 的简写作用是建立本地分支和远程分支的追踪关系。建立之后你后续直接敲 git push 和 git pullGit会自动知道跟哪个远程分支对应不用每次都带 origin 和分支名。push被远程拒绝的情况也很常见。最常见原因是远程分支有别人先推的提交而你本地对应分支没有这些提交。Git会拒绝你的pushnon-fast-forward这时先 git pull 把远程代码合并到本地解决可能的冲突再重新push。5. 冲突处理多人协作最贵的一堂课5.1 冲突是怎么产生的多人协作时两个人同时改了同一个文件的同一段代码后push的那一方就会遇到冲突——Git不知道应该保留谁的版本。这是Git操作中最容易让人头皮发麻的场景但应对方法其实是固定的。触发冲突的完整链路通常是你基于commit A修改了文件。同事基于同样的commit A修改了同一个文件的同一处区域并且他已经把代码推到了远程。你执行 git pullGit尝试把同事的提交合并到你的本地。你本地修改和远程修改在同一行发生碰撞Git停下并标记冲突。看到冲突的时候Git会用特殊标记在文件里标出双方内容 HEAD 你本地写的代码 远程拉下来的代码 分支名/提交ID5.2 解决冲突的标准流程碰到冲突不要慌按这个流程走# 1. 确认冲突文件列表 git status # 2. 打开冲突文件找到 标记手动逐条决定保留谁的代码 # 3. 改完后删除所有 、、 标记 # 4. 重新加入暂存区 git add 冲突文件路径 # 5. 提交合并 git commit -m merge: 合并远程代码解决冲突解决冲突时尽量不要单方面选择“保留本地的”或“保留远程的”——除非你能百分百确定另一边代码没用。正确做法是把标记内的两段代码都读一遍理解各自意图再决定哪个需要保留、哪个需要合并、哪个需要重写。如果冲突出现在你没有把握的业务逻辑里最稳妥的做法是找到改这块代码的同事当面或线上对齐。还有一个细节解决冲突的commit不要写“fix conflict”这种没信息量的话写清楚这个merge做了什么比如“merge: 合入登录页重构解决全局样式冲突”。5.3 避免冲突的日常习惯从根上减少冲突我的经验是这几条每天开工前先 git pull别让本地落后远程太久。大功能拆成小提交频繁push别攒三天再一次性推。一个任务开一个分支避免在main分支直接改代码。改动公共文件pom.xml、package.json、常量定义文件时先pull再改。遇到大规模重构提前在群里同步让其他人避开同一批文件。6. GitLab/GitHub/Gitee远程操作细节6.1 远程仓库地址管理大部分项目会配置多个远程地址。查看当前仓库的远程情况git remote -v如果需要在已有仓库上手动添加远程地址git remote add origin gitgithub.com:用户名/仓库名.git有的公司内网项目同时还需要跟官方上游仓库保持同步这时可以把官方仓库地址加一个 upstream 的远程名称git remote add upstream gitgithub.com:上游用户名/上游仓库名.git之后拉取上游更新git fetch upstream git merge upstream/main这个套路在参与开源项目、或内部基于开源项目做二次开发时极其常用。6.2 分支切换与检出日常开发中切换分支和拉取特定分支代码是最高频的操作。很多团队用git flow或主干开发模式不管哪种你都需要快速在分支间切换# 切换已存在的分支 git checkout develop # 从远程分支创建并切换到本地分支 git checkout -b feature-login origin/feature-login # 等价的新命令写法 git switch -c feature-login origin/feature-loginfetch和pull最大的区别在这里体现得最明显。git fetch 把所有远程分支的更新同步到本地但不会动你正在工作的代码git pull 则直接把你当前分支和远程对应分支做合并。如果你只是想看一眼同事新推的分支fetch就够了不需要pull也碰不到你正在改的东西。6.3 撤销操作后悔药怎么吃才安全提交代码过程中会有各种“手滑”操作。git reflog 是给你兜底的命令git reflog这个命令查看的是本地HEAD指针的历史移动记录——几乎你所有“危险操作”之前的快照都还在。只要你在reflog里找到操作前的commit ID就可以用 git reset 或 git cherry-pick 恢复现场。三个reset用法要分清git reset --soft HEAD~1 # 撤销最近一次提交保留改动在暂存区 git reset --mixed HEAD~1 # 撤销最近一次提交保留改动在工作区默认 git reset --hard HEAD~1 # 撤销最近一次提交改动彻底丢弃慎用--hard 是真正意义上的“回滚”改动不会保留也没有专门路径找回。我个人的习惯是除非我确定改动完全不需要了否则永远先试试 --soft 或 --mixed至少给代码留个体面。如果是已经push到远端的提交需要撤销不要用reset用 revertgit revert 提交IDrevert会生成一条“反向提交”来抵消指定提交的改动历史保持完整不会重写共享历史更适合团队协作流程。7. 日常够用的Git速查表整理一份我使用频率最高的Git命令清单覆盖90%开发日常按场景分类方便速查场景命令说明初始化git init当前目录变为Git仓库克隆git clone 地址复制远程仓库到本地查看状态git status查看文件变更状态暂存git add 文件把文件加入暂存区提交git commit -m 信息生成提交记录推送git push推送到远程拉取git pull拉取并合并远程代码仅拉取不合并git fetch同步远程分支信息查看历史git log --oneline一行式查看提交历史比对差异git diff查看工作区与暂存区差异切换分支git checkout 分支名切换分支新建分支git checkout -b 分支名新建并切换合并分支git merge 分支名把指定分支合入当前分支暂存改动git stash临时保存未提交的修改恢复暂存git stash pop恢复最新暂存的修改取消暂存git reset HEAD 文件把文件从暂存区移除撤销提交git reset --soft HEAD~1撤销提交保留改动反做提交git revert 提交ID生成反向提交抵消改动远程列表git remote -v查看远程仓库地址8. 一句经验收尾拉取和提交代码本质上是“同步”和“记录”两件事。同步要勤——每天pull、频繁push不要让分支之间的差距越拉越大记录要清晰——一次提交一件事信息说人话类型写规范。Git的命令体系虽然庞大但核心流程摸熟之后你会发现绝大多数日常操作就那么十来个命令。工具是死的习惯是活的。把提交、拉取、合并这三个动作练成肌肉记忆你就已经能顺畅地参与绝大多数团队协作项目了。