Git急诊室：5种报错急救指南，开发者入门教程

标题GitHub急诊室那些天天弹红字报错的“绝症”其实都是纸老虎标签Git报错、急救指南、VS Code、零基础避坑、保姆级教程前面咱们把分支、冲突、PR 这些“正规军”的打法全学完了。你以为从此以后就能在 GitHub 上纵横驰骋了天真了。Git 这个东西就像是养了一只脾气极其古怪的猫。你顺着它摸它很乖你只要有一个动作稍微不符合它的规矩它立马反咬一口给你弹出一屏幕红彤彤的英文报错然后死活不让你干活。很多新手一看到满屏英文脑子里就一句话“完了我电脑坏了代码没了。”别慌今天这篇咱们开个“急诊室”。我把新手在使用 VS Code 和 GitHub 时遇到频率最高的 5 种报错和诡异现象全摆出来。我不讲底层原理只教你“看到这行红字点哪里怎么活下来”。把这篇收藏起来下次报错的时候直接当字典查急诊病例 1“被拒门外”——推送被拒绝【案发现场】你在本地写完代码高高兴兴地点了“推送”。结果 VS Code 底下弹出一个红框里面写着一句最长、最吓人的话Push rejected: Push to origin/main was rejected推送被拒绝推送到 main 分支被拒绝【病理分析】为什么拒绝你因为**“你的版本落后了”**。打个比方你手里拿的是第 3 版的账本你想塞进公司的保险柜。但你不知道你周末休息的时候同事小王已经往保险柜里塞了第 4 版的账本。Git 发现你的版本比云端老怕你把小王的代码覆盖掉所以“啪”地把门关上了。【急救措施三步走】千万不要点强制推送如果你看到了一个Force Push的选项把它当成核按钮绝对别碰。点开 VS Code 左侧的“源代码管理”面板。点击底部状态栏的同步按钮或者点...- 拉取。情况 A如果直接拉取成功了说明你们没改同一个文件这时候你再点“推送”就能传上去了。情况 B如果拉取后文件前面出现了白色的C冲突恭喜你请翻出我上一篇文章去解决冲突解决完再推送。急诊病例 2“放错抽屉”——代码写错分支了【案发现场】你本来应该在add-login登录功能的分支上写代码结果忘了切分支。写了整整两个小时500 行代码全写在了main主线上。现在直接推送会破坏主线不推送这 500 行代码白写了。【病理分析】这就好比你把日记写到了公司的正式报表本上现在你想把这几页纸撕下来贴到你自己的私人日记本上还不能把报表本弄坏。【急救措施时光暂停法】千万不要直接新建分支如果你现在点左下角建分支那 500 行代码也会跟着过去main 里依然有没意义。点击 VS Code 源代码管理面板右上角的...三个点。找到Stash暂存- 点击Stash All。(此时你屏幕上的 500 行代码瞬间消失main 分支干干净净就像你没写过一样。别慌代码被藏进保险箱了。)点击左下角的main新建一个分支叫add-login并切换过去。再次点...- 找到Stash- 点击Pop Stash。(咻——那 500 行代码完好无损地出现在了add-login分支里)提交、推送。完美挽救急诊病例 3“时空迷失”——不小心进入了“幽灵模式”【案发现场】你在看 VS Code 左侧的“历史记录”或者 GitHub 网页上的提交记录时手贱点了一下某一次提交。突然VS Code 左下角的分支名不见了变成了一长串黄色的乱码比如a1b2c3d。然后你发现你没法推送也没法拉取写了新代码也提交不上去。【病理分析】这叫HEAD detached脱离头指针 / 游离状态。打个比方Git 的时间线是一列火车分支是车厢。你刚才点那个提交记录相当于你从车厢里跳了出去跳到了铁轨旁边的某根枕木上。你现在是个“幽灵”不在任何车厢里当然没法带着车厢往前开。【急救措施非常简单】什么都别动代码还在点击 VS Code 左下角的那串黄色乱码a1b2c3d。在弹出的列表里点击你想回去的车厢比如main或者add-login。噔噔你回到车厢里了。(注意如果你在幽灵模式下写了代码切回分支后代码可能会消失。如果真遇到这种情况去终端输入git stash切回分支后再git stash pop但这属于极低概率事件不用深究。)急诊病例 4“吸尘器失灵”——不小心把“垃圾”传上去了【案发现场】你新建项目时忘了配.gitignore文件。结果把node_modules几百兆的依赖包、或者.exe安装包直接推送到了 GitHub 上。现在仓库体积巨大拉取极慢甚至在网页上都打不开。【病理分析】Git 就像个没有分辨力的吸尘器你让它吸它连砖头都给你吸进去。一旦吸进去哪怕你后来在电脑上把这些文件删了再推送Git 也只是记录了“你删了个文件”但那个几百兆的文件依然死死地躺在历史记录里【急救措施从云端彻底抹除】这步稍微复杂一点但必须学会第一步让 Git 以后别再吸这些垃圾在你的项目根目录建一个文件名字就叫.gitignore前面有个点。在里面写上node_modules/ *.exe .DS_Store这相当于给吸尘器装了个过滤网。第二步把已经吸进去的垃圾吐出来解除追踪不要手动删文件在 VS Code 里打开终端VS Code 顶部菜单 - 终端 - 新建终端。输入这行命令意思是把所有文件从 Git 的记录里移除但不删除你电脑上的实体文件git rm -r --cached .按回车。会跑出一堆文字别管它把刚才吐出来的垃圾加进购物车点左侧的号。写备注“清理历史垃圾文件”点✓提交。推送。做完这一套GitHub 上的新提交里就没有这些大文件了。注如果想要把以前历史记录里的大文件也彻底删掉减肥需要用BFG等高级工具那属于外科手术级别新手暂时别碰只要以后不传就行。急诊病例 5“错别字尴尬症”——提交信息写错了/漏传了一个文件【案发现场】你刚写完代码点了号写了个提交信息“修复了登陆bug”点了✓。结果下一秒发现卧槽“登陆”写错了应该是“登录”或者发现还有一个小文件忘了点号。【病理分析】你想撤回刚才的提交但又不想像“手滑瞬间”那篇文章里那样用复杂的Revert生成一个反向记录你只想神不知鬼不觉地修改刚才那一次提交。【急救措施橡皮擦功能】前提你还没有点击推送代码只在你本地如果是漏了文件把那个漏掉的文件点号加入购物车。如果是代码写错了把代码改对保存。点击源代码管理右上角的...三个点。找到Commit提交选项鼠标悬停上去会弹出子菜单。点击Amend Commit修改上一次提交注意看上面的输入框你上次写的“修复了登陆bug”又回来了。把它改成“修复了登录bug”。点击右边的✓勾号。结果Git 会把你的新修改和上一次提交完美地“融合”在一起。在历史记录里依然只有一条提交记录而且信息已经变成了正确的。就像你拥有了时光倒流的橡皮擦急诊室结语发现没有Git 所有的报错底层的逻辑其实都非常讲道理拒绝你是因为怕你弄丢别人的东西推送被拒。卡住你是因为不知道该听谁的合并冲突。报错你是因为你不在正常的工作流里游离状态。遇到红字不要慌也不要瞎点。把它复制下来扔给 ChatGPT或者查查我这篇“急诊室手册”看懂它到底在“保护”什么然后顺着它的规矩去操作。只要你不点“强制推送”、不乱删本地的.git隐藏文件夹在 Git 的世界里你其实是死不掉的。代码永远都在只不过有时候藏在了你需要找找的地方而已。把这篇放进收藏夹去放心大胆地写代码吧报错了咱治病就是