Git 這東西剛?cè)胄心菚何乙脖凰垓v得夠嗆。第一次看到fatal: not a git repository的時候我盯著屏幕愣了五分鐘心想“我不就在項目文件夾里嗎怎么就不是倉庫了”。后來帶過幾個新人發(fā)現(xiàn)大家卡住的地方驚人地相似裝完了不知道配置啥、clone下來不敢動、commit完了發(fā)現(xiàn)提交信息寫錯了不知道怎么改、密鑰配了半天還是login failed。這篇東西就是把這些年踩過的坑、帶人時被問得最多的問題從頭到尾捋一遍。不管你是剛下載完 Git 還沒打開過還是已經(jīng)能敲幾個命令但一遇到報錯就慌看完應該都能有點收獲。我會從“Git 到底在干嘛”講起一直講到worktree這種稍微進階一點的用法中間穿插大量實際會遇到的報錯和排查思路。1. Git 到底解決了什么問題1.1 從“復制粘貼改文件名”說起沒有版本控制的時候我們是怎么管理文件版本的大概率是這樣方案.doc、方案_修改版.doc、方案_最終版.doc、方案_最終版_真的最終.doc。這種做法的死穴在于你根本說不清兩個版本之間到底改了什么想回退到某個中間狀態(tài)基本靠猜多人協(xié)作更是災難——你把文件發(fā)給我我改完發(fā)給你你再改最后誰的版本是對的都不知道。Git 的核心價值就一句話它記錄的是每一次改動的快照和改動之間的差異而不是一堆孤立的文件副本。每次你提交commitGit 會把當前所有文件的狀態(tài)拍一張“照片”存起來同時記錄這張照片和上一張之間哪些文件變了、怎么變的。這樣你隨時可以回到任何一張歷史照片也可以清楚地看到某一行代碼是誰在什么時候改的。我習慣用一個類比Git 就像給項目裝了一臺帶時間軸的監(jiān)控攝像頭。你不需要手動保存“第 3 版”“第 5 版”攝像頭自動記錄每一幀你想看哪一幀就看哪一幀還能對比兩幀之間的差異。1.2 三個區(qū)域工作區(qū)、暫存區(qū)、本地倉庫理解 Git 最關鍵的一步是搞清楚它把文件分成了三個區(qū)域。很多人命令敲得挺溜但一出問題就懵根源就是沒搞明白這三個區(qū)的關系。工作區(qū)Working Directory你眼睛能看到、手能直接編輯的那些文件就是工作區(qū)。你在編輯器里改代碼改的就是工作區(qū)。暫存區(qū)Staging Area / Index一個中間緩沖區(qū)。你改完文件后用git add把想提交的改動“挑”進暫存區(qū)。為什么要有這么個東西因為一次改動可能涉及好幾個文件但你可能只想先提交其中一部分暫存區(qū)就是讓你精確控制“這次提交到底包含哪些改動”的地方。本地倉庫Local Repositorygit commit之后暫存區(qū)里的內(nèi)容就被打包成一個永久的快照存進本地倉庫。這個倉庫就在你項目目錄下的.git文件夾里是一個完整的、獨立的歷史記錄庫。這三個區(qū)的流轉(zhuǎn)關系是工作區(qū) →git add→ 暫存區(qū) →git commit→ 本地倉庫。反過來git checkout或git restore可以把倉庫或暫存區(qū)的內(nèi)容拉回工作區(qū)。搞懂這條鏈路后面 80% 的命令你都能自己推導出它是干嘛的。1.3 為什么是分布式而不是集中式早期的版本控制工具比如 SVN是集中式的所有歷史記錄存在一臺中央服務器上你本地只有當前版本的文件。想提交得聯(lián)網(wǎng)。服務器掛了大家都別干活了。想看歷史得從服務器拉。Git 是分布式的意味著你clone下來的那一刻整個項目的完整歷史就已經(jīng)在你本地了。你可以在斷網(wǎng)的情況下提交、查看歷史、切換分支、對比差異所有操作都是本地完成的。只有當你需要和別人同步時才需要聯(lián)網(wǎng)推送或拉取。這個設計帶來的好處是實打?qū)嵉奈以诟哞F上改代碼、提交完全不受網(wǎng)絡影響服務器出問題也不影響我本地繼續(xù)工作等恢復了再推上去就行。代價是初次clone會比較慢因為要下載全部歷史以及本地會占更多磁盤空間但對現(xiàn)在的硬盤容量來說這根本不是事。2. 安裝與配置把地基打牢2.1 Windows 上安裝 Git 的完整步驟Windows 用戶下載 Git 最穩(wěn)妥的渠道是官網(wǎng) git-scm.com下載頁會自動識別你的系統(tǒng)給出對應安裝包。下載下來是一個.exe文件雙擊運行。安裝過程中有一堆選項新手最容易在這里犯迷糊。我挑幾個關鍵的說說選擇默認編輯器默認是 Vim但如果你不熟悉 Vim 的操作進去容易出來難強烈建議改成 Notepad 或者 VS Code。這個編輯器是 Git 在你需要寫提交信息時調(diào)用的選一個你順手的能省很多事。調(diào)整 PATH 環(huán)境變量這一步選“Git from the command line and also from 3rd-party software”這樣你在 CMD、PowerShell、VS Code 的終端里都能直接用git命令。選錯了的話只有在 Git Bash 里才能用 git會很別扭。換行符處理選“Checkout Windows-style, commit Unix-style line endings”。Windows 和 Unix 的換行符不一樣這個選項讓 Git 在檢出時自動轉(zhuǎn)成 Windows 格式、提交時轉(zhuǎn)成 Unix 格式能避免很多跨平臺協(xié)作時的“整個文件都顯示被修改了”的詭異問題。終端模擬器選 MinTTY默認它比 Windows 自帶的 CMD 好用得多支持更好的顏色和字體。裝完之后在任意文件夾右鍵如果能看到“Git Bash Here”和“Open Git Bash here”說明裝好了。打開 Git Bash敲git --version能輸出版本號就萬事大吉。2.2 裝完必做的三項配置很多人裝完 Git 就直接開始用結(jié)果第一次commit就報錯說不知道你是誰。Git 需要知道每次提交是誰做的所以裝完第一件事就是配置身份。git config --global user.name 你的名字 git config --global user.email 你的郵箱--global表示這是全局配置對你這臺電腦上所有倉庫生效。如果你某個項目想用不同的身份可以在那個項目目錄下不加--global再配一次項目級配置會覆蓋全局配置。第三項配置是設置默認分支名。Git 早期默認分支叫master現(xiàn)在業(yè)界普遍改用main。為了避免每次新建倉庫都要手動改名可以提前設好git config --global init.defaultBranch main配完之后用git config --list檢查一下能看到你剛設的三項就對了。這里有個小坑user.name里如果帶中文在某些終端里可能顯示亂碼建議用英文或者拼音反正這只是個標識不影響功能。2.3 配置 Gitee 密鑰免密推送的正確姿勢每次推送都要輸密碼太煩用 SSH 密鑰可以免密。Gitee 和 GitHub 的配置邏輯一樣這里以 Gitee 為例。第一步生成密鑰對。在 Git Bash 里執(zhí)行ssh-keygen -t rsa -b 4096 -C 你的郵箱一路回車就行它會默認在~/.ssh/目錄下生成兩個文件id_rsa私鑰絕對不能給別人和id_rsa.pub公鑰要貼到 Gitee 上去。第二步查看公鑰內(nèi)容cat ~/.ssh/id_rsa.pub把輸出的那一整串以ssh-rsa開頭復制下來。第三步登錄 Gitee進入“設置” → “SSH 公鑰”把剛才復制的內(nèi)容粘貼進去起個名字比如“我的筆記本”保存。第四步驗證是否配置成功ssh -T gitgitee.com如果看到類似“Hi xxx! Youve successfully authenticated”的提示就說明配好了。如果提示Permission denied (publickey)八成是公鑰沒貼對或者你生成密鑰時改了默認文件名導致 Git 找不到檢查一下~/.ssh/目錄下有沒有id_rsa和id_rsa.pub。注意私鑰文件id_rsa千萬不要發(fā)給任何人也不要用微信、郵件傳。它相當于你倉庫的鑰匙泄露了別人就能以你的身份推送代碼。3. 日常使用從 clone 到 push 的完整鏈路3.1 拿到一個項目clone 的正確打開方式git clone是把遠程倉庫完整復制到本地的命令包括所有歷史記錄和分支。git clone gitgitee.com:用戶名/倉庫名.git如果你用 HTTPS 地址https://gitee.com/...每次推送都要輸賬號密碼用 SSH 地址gitgitee.com:...則走密鑰免密。所以配好密鑰之后建議統(tǒng)一用 SSH 地址。clone 下來之后進入項目目錄你會看到一個.git文件夾默認隱藏。這個文件夾就是本地倉庫的本體刪了它項目就變成普通文件夾了所有歷史記錄都沒了。所以千萬別手賤去刪它。有個常見報錯fatal: not a git repository (or any of the parent directories): .git。這個報錯的意思是“當前目錄及其父目錄都找不到 .git 文件夾”也就是說你不在一個 Git 倉庫里。解決辦法很簡單cd到正確的項目目錄或者確認你是不是忘了git init。3.2 改完代碼怎么提交add、commit 的配合假設你改了兩個文件index.html和style.css?，F(xiàn)在想把它們提交上去。第一步看看當前狀態(tài)git status它會告訴你哪些文件被修改了、哪些是新增的、哪些已經(jīng)進了暫存區(qū)。這個命令我建議你養(yǎng)成習慣每次 add 和 commit 之前都敲一下心里有數(shù)。第二步把改動加入暫存區(qū)git add index.html style.css或者如果你確定所有改動都要提交可以偷懶用git add .注意后面有個點表示當前目錄下所有改動。但我不太推薦無腦git add .因為有時候你會改一些臨時文件、調(diào)試代碼不小心就一起提交上去了。第三步提交git commit -m 修復首頁輪播圖不顯示的問題-m后面跟的是提交信息。提交信息怎么寫有講究我的習慣是用一句話說清楚“這次改了什么、為什么改”不要寫“更新”“修改”這種沒信息量的詞。因為三個月后你回頭看歷史唯一能幫你回憶起來的就是這行字。3.3 提交信息寫錯了怎么辦commit --amend 實戰(zhàn)這是被問得最多的問題之一剛 commit 完發(fā)現(xiàn)提交信息打錯字了或者漏加了一個文件怎么辦如果還沒推送到遠程用git commit --amend就能補救。改提交信息git commit --amend -m 新的提交信息漏加了文件git add 漏掉的文件 git commit --amend --no-edit--no-edit表示沿用原來的提交信息只把新加的文件合并進上一次提交。這里有個關鍵點--amend實際上是用一個新的提交替換掉上一個提交提交的哈希值會變。所以如果上一次提交已經(jīng)推送到遠程了你 amend 之后再推會被拒絕因為本地和遠程的歷史不一致。這時候要么用git push --force危險會覆蓋遠程歷史多人協(xié)作時慎用要么就老老實實再提交一次。實操心得--amend只適合“還沒推送”的場景。一旦推上去了除非你確定這個分支只有你一個人在用否則別 force push容易把別人的工作覆蓋掉。3.4 推送到遠程push 與 pull 的節(jié)奏本地提交完了要同步到遠程git push如果是第一次推送這個分支可能需要指定上游git push -u origin main-u是--set-upstream的簡寫設置之后以后直接git push就行不用每次指定遠程和分支。反過來如果別人推了新代碼你要拉下來git pullgit pull實際上是git fetch拉取遠程最新加git merge合并到本地兩個操作的組合。我個人的習慣是先用git fetch看看遠程有什么變化確認沒問題再git merge這樣更可控。直接git pull有時候會觸發(fā)意料之外的合并沖突尤其是在你本地有未提交改動的時候。4. 那些讓人頭大的報錯和疑難雜癥4.1 常見報錯速查表我把這些年遇到的高頻報錯整理成了一張表遇到問題先對號入座報錯信息原因解決辦法fatal: not a git repository當前目錄不是 Git 倉庫cd到項目目錄或git init初始化Please tell me who you are沒配置 user.name/user.email執(zhí)行 2.2 節(jié)的兩條 config 命令Permission denied (publickey)SSH 密鑰沒配好檢查公鑰是否貼到平臺、私鑰是否存在failed to push some refs遠程有你本地沒有的提交先git pull再git pushYour local changes would be overwritten本地有未提交改動pull 會覆蓋先 commit 或 stash 再 pulllogin failed. check api token認證信息過期或錯誤重新配置密鑰或檢查 tokendetached HEAD處于游離頭指針狀態(tài)git switch -回到分支或新建分支4.2 密鑰配置失敗的排查思路login failed. check api token or gitlab version這類報錯本質(zhì)是認證沒通過。排查順序是這樣的先確認你用的是 SSH 還是 HTTPS。如果是 HTTPS那走的是賬號密碼或 token跟 SSH 密鑰沒關系。很多人配了 SSH 密鑰卻用 HTTPS 地址 clone然后奇怪為什么還要輸密碼就是這個原因。如果是 SSH按這個順序查ssh -T gitgitee.com能不能通不通的話ssh -vT gitgitee.com加-v看詳細日志它會告訴你用了哪個密鑰文件、認證到哪一步失敗了。常見原因是密鑰文件權(quán)限不對Linux/Mac 下~/.ssh應該是 700私鑰應該是 600或者你生成密鑰時自定義了文件名但沒在~/.ssh/config里配置對應關系。還有一種情況是公司網(wǎng)絡環(huán)境對 SSH 端口有限制這時候可以改用 HTTPS 加 token 的方式。Gitee 和 GitHub 都支持在設置里生成個人訪問令牌token用 token 代替密碼進行 HTTPS 認證。4.3 合并沖突不要慌一步步來沖突是新手最怕的東西但其實它沒那么可怕。沖突的本質(zhì)是同一個文件的同一部分你和別人改了不一樣的內(nèi)容Git 不知道該聽誰的于是把決定權(quán)交給你。沖突發(fā)生時打開沖突文件你會看到這樣的標記 HEAD 你本地的代碼 遠程拉下來的代碼 branch-name和之間是你本地的版本和之間是遠程的版本。你要做的就是手動決定保留哪個、刪掉哪個或者把兩者融合。編輯完之后把那些、、標記全部刪掉保存文件然后git add這個文件再git commit完成合并。我的經(jīng)驗是沖突文件多的時候用 VS Code 這類編輯器打開它會用顏色高亮沖突區(qū)域還提供“保留當前”“保留傳入”“兩者都保留”的快捷按鈕比手動改快得多。5. 進階但實用的幾個技巧5.1 git worktree同時處理多個分支git worktree是我近兩年用得越來越多的功能。場景是這樣的你正在feature-a分支上開發(fā)突然線上出了個 bug 需要緊急修復。傳統(tǒng)做法是git stash存一下當前改動切到main修 bug修完再切回來stash pop。但如果你當前改動很多、很雜stash 來 stash 去很容易出錯。worktree的思路是給同一個倉庫開一個“平行工作目錄”每個目錄可以檢出不同的分支互不干擾。git worktree add ../hotfix main這條命令會在當前目錄的上一級創(chuàng)建一個叫hotfix的文件夾里面檢出main分支。你可以在那個文件夾里修 bug、提交、推送完全不影響你當前目錄里的工作。修完之后git worktree remove ../hotfix就把那個工作目錄刪掉了。這個功能特別適合“手頭活沒干完又要緊急處理另一件事”的場景比 stash 干凈利落得多。5.2 小烏龜TortoiseGit不想敲命令的替代方案不是所有人都喜歡命令行。TortoiseGit俗稱“小烏龜”是 Windows 上的一個 Git 圖形化客戶端裝完之后你的文件夾右鍵菜單里會多出一堆 Git 相關選項。它的好處是直觀改了哪些文件、每個文件改了什么都能在圖形界面里看得清清楚楚提交、拉取、推送都是點按鈕沖突了也有可視化的合并工具。對于剛?cè)腴T、還沒建立起命令行肌肉記憶的人來說小烏龜能幫你快速理解 Git 的工作流。但我的建議是圖形工具可以用但命令行的核心操作add、commit、push、pull、status、log還是要會。因為一旦出問題圖形界面能給你的信息往往不夠還是得回到命令行看詳細日志。而且很多服務器環(huán)境根本沒有圖形界面只能敲命令。5.3 IDEA 里怎么用 Git 提交代碼用 IDEA 開發(fā)的話其實不太需要單獨開終端敲 Git 命令IDEA 內(nèi)置了完整的 Git 集成。提交代碼的流程是改完代碼后在左側(cè)的 Commit 面板里能看到所有改動的文件。勾選你想提交的文件在下方輸入提交信息點 Commit 就完成了本地提交。如果想直接推送到遠程點 Commit and Push。IDEA 的 diff 視圖很好用雙擊文件就能看到左右對比哪行改了、哪行刪了一目了然。沖突的時候它也有三欄合并工具比手動改文件舒服很多。不過有個坑要注意IDEA 默認可能不會自動git add新文件你新建的文件需要手動勾選或者右鍵 Add 一下否則提交的時候會漏掉。6. 我踩過的坑和給你的建議6.1 提交前一定要 git status這個習慣能幫你避免 90% 的低級錯誤。我見過太多人git add .之后直接 commit結(jié)果把.idea、node_modules、編譯產(chǎn)物、甚至包含密碼的配置文件一起提交上去了。這些東西一旦進了歷史清理起來非常麻煩。正確的做法是在項目根目錄放一個.gitignore文件把不需要版本控制的東西寫進去node_modules/ .idea/ *.log .env dist/.gitignore要在項目初期就建好等文件已經(jīng)提交了再往.gitignore里加是沒用的Git 還是會繼續(xù)跟蹤那些文件。已經(jīng)提交了的話需要用git rm --cached 文件名把它從版本控制里移除但保留本地文件然后再提交一次。6.2 提交粒度要小信息要清楚一次提交只做一件事。不要把“修復 bug”“重構(gòu)代碼”“調(diào)整格式”混在一個提交里。因為將來如果發(fā)現(xiàn)那個 bug 修復有問題想回退你會把重構(gòu)和格式調(diào)整也一起退掉很麻煩。提交信息我習慣用這樣的格式第一行是簡短概括不超過 50 字空一行然后詳細說明改了什么、為什么改。雖然多寫幾個字但將來查歷史的時候你會感謝自己。6.3 不要害怕犯錯Git 幾乎什么都能救回來新手最大的心理障礙是“怕把代碼搞丟”。實際上 Git 的設計非常保守只要你 commit 過的東西基本都能找回來。git reflog記錄了 HEAD 的所有移動歷史哪怕你誤刪了分支、reset 錯了都能通過 reflog 找到那個提交的哈希值然后恢復。真正會丟數(shù)據(jù)的只有兩種情況一是你改了文件但從來沒 add 也沒 commit然后執(zhí)行了會覆蓋工作區(qū)的操作二是你 force push 覆蓋了遠程歷史而本地又沒有備份。除此之外Git 都有辦法救。所以我的建議是大膽用多試。建個測試倉庫隨便折騰把各種命令都試一遍比看十篇教程都管用。Git 這東西光看是學不會的必須上手敲。6.4 關于 git 目錄泄露的提醒最后提一個安全相關的點。有些項目在部署的時候不小心把.git目錄也一起傳到了 Web 服務器上導致別人可以通過瀏覽器訪問你的域名/.git/config之類的路徑把整個倉庫的源碼和歷史記錄都下載下來。這是個很常見的安全疏漏。防范方法很簡單部署的時候確保.git目錄不在 Web 根目錄下或者在服務器配置里禁止訪問以.git開頭的路徑。如果你用的是自動化部署工具檢查一下它的配置確認沒有把.git一起打包上傳。這個坑一旦踩了源碼泄露是小事如果歷史提交里有過密碼、密鑰那問題就大了。我自己現(xiàn)在的習慣是任何項目部署前都先確認一遍.git目錄的位置寧可多花兩分鐘檢查也不要事后補救。