前言從“一個(gè)文件夾復(fù)制10個(gè)版本”到真正敢改代碼當(dāng)我第一次用Git是在一個(gè)凌晨兩點(diǎn)鐘項(xiàng)目眼看著少了一塊核心代碼而我手頭只有三天前的壓縮包備份。當(dāng)時(shí)心里就一個(gè)念頭如果早知道“版本管理”四個(gè)字這么值錢我絕對不折騰那幾個(gè)小時(shí)。后來我把Git吃到嘴里、嵌進(jìn)工作流里發(fā)現(xiàn)一個(gè)規(guī)律想在一個(gè)項(xiàng)目里安全地搞事情不管是一個(gè)人寫死磕需求還是三個(gè)人一起薅頭發(fā)聯(lián)調(diào)Git 云端倉庫這套組合就是你最后的保險(xiǎn)繩。這話說起來很輕但真正撐起“敢改、能退、丟不了”這三個(gè)字背后全是細(xì)節(jié)。這篇保姆級教程要解決的就是最現(xiàn)實(shí)的問題電腦宕了怎么辦、誤刪代碼怎么辦、多臺(tái)電腦同步怎么辦、同事改了我文件怎么辦。我會(huì)把Git安裝、Git配置、SSH認(rèn)證、倉庫初始化、首次推送、日常提交、分支合并這些環(huán)節(jié)全部拆開用我踩過的坑代替你即將踩的坑。文章面向小白但也照顧已經(jīng)裝了Git、只是用不溜的人——如果你發(fā)現(xiàn)自己在某些命令上從來沒有理解過“為什么要這樣”那這篇文章值得你從頭看完。1. 為什么你正在用的“復(fù)制粘貼備份法”遲早出事1.1 三個(gè)完全不該被忽視的事實(shí)先聊幾個(gè)場景大家應(yīng)該都不陌生第一你辛辛苦苦寫了一下午的代碼想試試新方案改完發(fā)現(xiàn)全亂了CtrlZ按了二十下也沒回到想要的狀態(tài)第二你把項(xiàng)目壓縮包命名為“最終版”半年后你的電腦里有“最終版”、“最終版2”、“最終版復(fù)件”、“最終版真最終”再往后你自己都分不清哪個(gè)才是能跑的第三你換了臺(tái)電腦發(fā)現(xiàn)最新代碼還躺在舊電腦的桌面上而舊電腦已經(jīng)被你老婆拿去裝了CAD。這三件事的本質(zhì)都一樣你的代碼只有一處在存在而且這處的狀態(tài)全靠你手動(dòng)記錄。Git出現(xiàn)之前大家也這么干但Git出現(xiàn)之后還這么干就有點(diǎn)對不起自己花的電費(fèi)了。Git做到的事情其實(shí)就一句話用提交歷史管理你的每一個(gè)版本狀態(tài)用云端倉庫讓你的代碼在任何一臺(tái)能聯(lián)網(wǎng)的電腦上隨時(shí)拉取。版本靠“提交”記錄而不是靠“另存為”這就是它和壓縮包備份最根本的區(qū)別。1.2 云端倉庫到底解決了什么問題有朋友會(huì)問那我在本地建個(gè)Git倉庫不開云端行不行行絕對行。但只搭本地倉庫隱患依然在硬盤壞了呢電腦進(jìn)水了呢你的代碼還是沒了。云端倉庫存在的意義就是把本地倉庫的完整副本同步到一臺(tái)或者多臺(tái)你控制之外的服務(wù)器上讓代碼至少存在三處本地工作區(qū)、本地Git倉庫、云端倉庫。這個(gè)“三處存在”的邏輯就是安全感的來源——你丟了任何一處都可以從另一處找回來。很多人還有個(gè)誤區(qū)覺得“我把代碼傳到云端是不是就公開了”不是的你完全可以選擇私有倉庫。以國內(nèi)常用的Gitee碼云為例新建倉庫時(shí)有一個(gè)“私有”選項(xiàng)勾選后只有你自己或被你邀請的人能看見代碼。GitHub雖然免費(fèi)版也支持私有倉庫但在國內(nèi)網(wǎng)絡(luò)環(huán)境的連接速度方面差距還是很真實(shí)的。所以我后面的例子會(huì)以Gitee為主同時(shí)也會(huì)提到GitHub的對應(yīng)操作兩邊邏輯一樣只是一個(gè)服務(wù)器在外面一個(gè)在國內(nèi)。至于GitLab這類自建系統(tǒng)其實(shí)也是同一套Git協(xié)議懂了核心原理以后換任何一家托管平臺(tái)都是十分鐘的事。2. 先把Git裝明白版本選擇、安裝步驟、初始化配置2.1 安裝之前必須做的一個(gè)認(rèn)知準(zhǔn)備Git不是編程語言它是一個(gè)命令行工具。所以你安裝Git之后桌面不會(huì)多出一個(gè)雙擊打開的圖標(biāo)你看到的會(huì)是一堆命令行。很多小白在這一步就退回去了覺得“我學(xué)不會(huì)”。其實(shí)你只需要記住三四個(gè)命令就能開始干活比如git add、git commit、git push、git pull其他都是進(jìn)階內(nèi)容。我甚至建議你就把這四個(gè)命令當(dāng)成日常用語先跑起來再慢慢擴(kuò)充。版本選擇上我建議大家直接去官網(wǎng)git-scm.com下載最新穩(wěn)定版別用網(wǎng)上流傳的“綠色版”或者第三方打包版。Git本身更新不算頻繁但每次更新都在修復(fù)安全問題裝官方版最省心。Windows用戶下載.exe安裝包后一路Next就行中間有一步“選擇默認(rèn)編輯器”如果你不會(huì)用Vim建議選Notepad或者VS Code不然后面提交信息會(huì)卡在一個(gè)“按i編輯按Esc退出”的界面里我第一次用Vim寫提交信息直接呆住了十分鐘。macOS用戶建議優(yōu)先用brew install git如果你還沒裝Homebrew也可以直接下載官方安裝包。Linux用戶更簡單Ubuntu系執(zhí)行sudo apt install gitCentOS系執(zhí)行sudo yum install git。裝完之后打開命令行輸入git --version能看到版本號就說明裝好了。2.2 安裝完畢后的“第一件事”不是你想象中的push很多人裝完Git馬上就想去建倉庫結(jié)果在配置用戶名和郵箱這步出了問題。Git的每個(gè)提交都會(huì)記錄作者信息如果你不設(shè)置它默認(rèn)取你的系統(tǒng)用戶名提交記錄里就會(huì)變成一串很怪的名字而且后患無窮別人看到提交記錄不知道是誰改的你自己換臺(tái)電腦也不知道上次提交是你改的。打開命令行執(zhí)行下面兩行命令git config --global user.name 你的名字 git config --global user.email 你的郵箱example.com注意這里的--global參數(shù)意思是這臺(tái)電腦上的所有項(xiàng)目都用這個(gè)身份。如果你有些項(xiàng)目想用另一個(gè)身份提交可以去掉--global進(jìn)入項(xiàng)目目錄后單獨(dú)設(shè)置項(xiàng)目級別的用戶名和郵箱。還有一個(gè)細(xì)節(jié)容易被忽略提交用的郵箱最好和云端倉庫賬號的郵箱保持一致否則你在Gitee或GitHub上雖然能push但提交記錄不會(huì)歸到你的頭像下面貢獻(xiàn)圖也是空白的。我身邊不止一個(gè)同事因?yàn)檫@個(gè)原因盯著空蕩蕩的綠色格子懷疑自己是不是被平臺(tái)限流了——其實(shí)只是郵箱沒對齊。完成之后可以用一個(gè)命令檢查配置是否生效git config --list這個(gè)命令會(huì)打印出當(dāng)前所有Git配置主要看user.name和user.email有沒有正確。2.3 裝完就遇到的第一個(gè)高頻坑git不是內(nèi)部或外部命令Windows用戶裝完Git很可能遇到這個(gè)提示“git不是內(nèi)部或外部命令”。原因無非兩個(gè)要么安裝時(shí)沒有勾選“Add Git to PATH”選項(xiàng)要么安裝完之后沒有重新打開命令行窗口環(huán)境變量沒刷新。解決辦法是重新運(yùn)行安裝程序在對應(yīng)步驟找到“Git from the command line and also from 3rd-party software”這個(gè)選項(xiàng)選中它重裝就行。裝完之后務(wù)必新開一個(gè)CMD或PowerShell窗口再執(zhí)行g(shù)it --version你會(huì)發(fā)現(xiàn)一切正常。還有一個(gè)小提示W(wǎng)indows的Git默認(rèn)還會(huì)安裝一個(gè)叫“Git Bash”的迷你終端我建議大家初期就在這個(gè)環(huán)境里操作它模擬了類Unix的命令比如pwd、ls -la都挺好用比在CMD里面對反斜杠路徑舒服太多了。我目前工作里的90%命令都是在Git Bash里敲的已經(jīng)成了肌肉記憶。3. 在云端開一個(gè)“安全屋”以Gitee為例創(chuàng)建倉庫3.1 新建倉庫的每一步選擇都很關(guān)鍵去Gitee官網(wǎng)注冊并登錄后點(diǎn)右上角的“”號選擇“新建倉庫”。這一頁幾個(gè)選項(xiàng)我需要重點(diǎn)解釋一下因?yàn)槊總€(gè)選項(xiàng)都有人踩過坑。首先是“倉庫名稱”它會(huì)被寫進(jìn)云端倉庫的訪問地址里比如https://gitee.com/你的用戶名/倉庫名.git。名字建議用英文或拼音加下劃線不要出現(xiàn)空格和中文不然后續(xù)使用會(huì)有很多莫名的麻煩。其次是“路徑”Gitee會(huì)基于倉庫名稱自動(dòng)生成一個(gè)路徑你一般不用改。然后是“初始化倉庫”那一欄有一個(gè)“選擇開源許可證”的下拉菜單一套License規(guī)則。如果這個(gè)項(xiàng)目只是你自己用選“無”就行如果將來要開源最好先了解一下MIT和Apache的區(qū)別。再往下最關(guān)鍵的是“是否開源”單選按鈕。我強(qiáng)烈建議在你還沒決定把代碼公開之前一律選私有。這個(gè)選項(xiàng)后面對應(yīng)的是倉庫的可見性私有倉庫對普通使用者最友好的地方就是沒有“是否泄露代碼”的心理負(fù)擔(dān)你可以大膽地把各種半成品、測試代碼、草稿筆記全部推上去想推多少推多少。等哪天你決定開源了倉庫屬性隨時(shí)可以在設(shè)置里改成公開不需要重建倉庫。最后那一欄“使用Readme文件初始化這個(gè)倉庫”我建議勾選。原因后面會(huì)說它會(huì)自動(dòng)幫你生成一個(gè).git倉庫骨架并包含README這樣你第一次clone下來不會(huì)是個(gè)空目錄視覺上友好很多也能理解倉庫結(jié)構(gòu)。如果你追求極簡也可以不勾選無非是一個(gè)空倉庫自己初始化后推上去。3.2 SSH密鑰讓你不再每次輸密碼創(chuàng)建好云端倉庫后接下來就是打通本地和云端的認(rèn)證通道。Gitee和GitHub都支持兩種訪問方式HTTPS和SSH。HTTPS方式簡單粗暴——push和pull的時(shí)候彈窗讓你輸入用戶名和密碼SSH方式則是通過一對公私鑰完成身份認(rèn)證配置好之后永久不用再輸密碼還更安全。判斷你電腦上是否已有SSH密鑰可以看這個(gè)目錄ls ~/.ssh如果里面有id_rsa和id_rsa.pub這兩個(gè)文件說明你已經(jīng)有密鑰了直接跳過生成步驟如果沒有執(zhí)行下面命令生成一對新密鑰ssh-keygen -t rsa -b 4096 -C 你的郵箱example.com這里的-t rsa是指定用RSA算法-b 4096是密鑰長度-C是注釋一般寫郵箱就行。執(zhí)行后一路回車它會(huì)問你密鑰存放位置和密碼——如果你設(shè)置了密碼每次使用SSH時(shí)都需要輸入密鑰密碼我建議自己工作的機(jī)器上不設(shè)置密鑰密碼省得每次push都多一步。如果你擔(dān)心安全可以在私人電腦和不連公司網(wǎng)絡(luò)的機(jī)器上用再配合系統(tǒng)開機(jī)密碼風(fēng)險(xiǎn)已經(jīng)相對可控了。密鑰生成后查看公鑰的內(nèi)容cat ~/.ssh/id_rsa.pub把打印出來的一大串字母數(shù)字復(fù)制下來回到Gitee網(wǎng)頁點(diǎn)頭像進(jìn)入“設(shè)置”左側(cè)找到“SSH公鑰”粘貼保存。記住公鑰可以放心公開它本身就是用來分發(fā)的私鑰絕對不能外泄它相當(dāng)于你身份的鑰匙。配置好公鑰后執(zhí)行下面命令測試連接ssh -T gitgitee.com第一次連接會(huì)提示確認(rèn)主機(jī)指紋輸入yes回車。如果看到“Hi 你的用戶名! You‘ve successfully authenticated”就說明通道完全打通了。3.3 ssh認(rèn)證失敗怎么破三個(gè)最常見的原因“ssh認(rèn)證失敗”是我被問爛了的一個(gè)問題也是熱搜詞里排得比較靠前的。實(shí)際處理下來原因基本就三種。第一種公鑰粘貼時(shí)多了一個(gè)空格或者少了換行。SSH公鑰是嚴(yán)格格式的開頭是ssh-rsa中間一串文字結(jié)尾是郵箱這三段之間各有一個(gè)空格。如果你從終端復(fù)制的時(shí)候復(fù)制了換行符粘貼后就可能報(bào)認(rèn)證失敗。處理方式很簡單重新查看并重新粘貼別手動(dòng)清除任何空白。第二種ssh-agent沒加載密鑰。有些系統(tǒng)環(huán)境下即使你生成了密鑰agent進(jìn)程也沒自動(dòng)把私鑰帶進(jìn)來。這種情況執(zhí)行一下ssh-add ~/.ssh/id_rsa把它手動(dòng)加進(jìn)去再試。第三種你連的是GitHub卻用了Gitee的地址。我在本地用同一對密鑰同時(shí)配置了Gitee和GitHub這沒毛病但有時(shí)候域名敲錯(cuò)了或者倉庫遠(yuǎn)程地址寫錯(cuò)了也會(huì)報(bào)認(rèn)證失敗。這時(shí)候可以用git remote -v看看遠(yuǎn)程地址是否正確再?zèng)Q定下一步。如果你用的是HTTPS方式連遠(yuǎn)程倉庫認(rèn)證失敗的另一個(gè)常見原因是賬號密碼錯(cuò)誤但Gitee現(xiàn)在更推薦使用私人令牌Personal Access Token代替密碼你在網(wǎng)頁端生成一個(gè)令牌把它當(dāng)成密碼輸入即可。這個(gè)令牌的詳細(xì)生成路徑在頭像菜單下的“設(shè)置 - 私人令牌”里記得保存好因?yàn)殛P(guān)閉頁面后就看不到第二次了。4. 第一次把本地代碼推到云端兩條路線一次走通4.1 路線一本地已有代碼把整個(gè)項(xiàng)目交給Git管理假設(shè)你已經(jīng)有一個(gè)項(xiàng)目文件夾叫my-project現(xiàn)在要把它納入Git并推送到云端。第一步進(jìn)入這個(gè)目錄并初始化本地倉庫cd ~/my-project git initgit init會(huì)在當(dāng)前目錄生成一個(gè)隱藏的.git文件夾這個(gè)文件夾里裝的就是全部分支、歷史版本記錄和引用信息。如果你哪天想徹底退出版本管理把這個(gè).git文件夾刪掉就回到普通文件夾狀態(tài)但代價(jià)是丟失你在此項(xiàng)目上的所有提交歷史所以這個(gè)操作要慎重再慎重。第二步把項(xiàng)目目錄下的所有文件加入暫存區(qū)git add .這一步很多人不理解“暫存區(qū)”是什么意思。我用個(gè)生活類比暫存區(qū)就像超市購物車git add是把商品從貨架上拿進(jìn)購物車還沒結(jié)賬git commit才是到收銀臺(tái)結(jié)賬生成一張小票提交記錄。如果不加文件直接commitGit會(huì)提示“沒有暫存的內(nèi)容提交為空”。第三步提交并對本次提交寫說明git commit -m 初始化項(xiàng)目提交我的第一個(gè)版本-m參數(shù)后面跟的就是你的提交說明。這里我有個(gè)強(qiáng)烈建議提交信息不要寫“12345”或者“更新”要寫“修復(fù)了登錄頁在Safari下樣式錯(cuò)亂的問題”這樣的具體描述。理由很簡單等你的提交記錄累計(jì)到幾十條上百條你回看歷史時(shí)靠的就是這一行字含糊其辭等于白寫。第四步把云端倉庫地址關(guān)聯(lián)為遠(yuǎn)程倉庫git remote add origin gitgitee.com:你的用戶名/my-project.git這里的origin是一個(gè)別名它指代遠(yuǎn)程倉庫地址。后面你不用每次打超長URL只需要說git push originGit就知道要推送到哪里。你也可以把遠(yuǎn)程地址起名為gitee或github完全看個(gè)人習(xí)慣但絕大多數(shù)項(xiàng)目的默認(rèn)約定都是origin。第五步推送到云端git push -u origin master這里的-u參數(shù)會(huì)把本地master分支和云端master分支關(guān)聯(lián)起來以后你只需要git push不用每次指定分支名。所以-u只要第一次推的時(shí)候加一次就夠了后面可以省略。4.2 路線二云端倉庫已經(jīng)存在從零開始fork或clone還有一種常見情況云端倉庫已經(jīng)由別人創(chuàng)建好了或者你想從Gitee上拉取一個(gè)開源項(xiàng)目。這時(shí)你不需要執(zhí)行g(shù)it init直接克隆遠(yuǎn)程倉庫到本地即可git clone gitgitee.com:別人的用戶名/項(xiàng)目名.git這條命令會(huì)把這個(gè)項(xiàng)目整個(gè)下載下來包括全部提交歷史。如果你只想下載某個(gè)分支可以加-b參數(shù)git clone -b dev gitgitee.com:用戶名/項(xiàng)目名.git。我最開始學(xué)Git的時(shí)候分不清“clone”和“fork”的區(qū)別clone是把項(xiàng)目復(fù)制到你的本機(jī)fork是在云端創(chuàng)建一份拷貝。如果你想?yún)⑴c一個(gè)開源項(xiàng)目通常的做法是先在云端fork一份到自己賬號下再clone自己fork后的地址這樣你改動(dòng)的提交記錄會(huì)集中在自己倉庫里之后再通過Pull Request請求合并到原項(xiàng)目。這個(gè)流程在GitHub和Gitee上都是主流協(xié)作方式。4.3 第一次推送就卡住的常見場面很多人第一次push時(shí)最常遇到的是一個(gè)紅色報(bào)錯(cuò)“rejected - non-fast-forward”。這個(gè)報(bào)錯(cuò)的本質(zhì)是云端上有本地沒有的提交記錄而且兩者不是同一條歷史線。原因一般是云端倉庫初始化時(shí)勾選了“生成README”選項(xiàng)也就是說云端的提交已經(jīng)有一個(gè)了而你本地倉庫的提交是另外生成的兩邊各有一個(gè)平行歷史Git不知道怎樣合并。解決辦法有兩種一種是無腦撤銷云端倉庫重建適合項(xiàng)目剛開始還沒什么內(nèi)容的情況另一種是老老實(shí)實(shí)把云端歷史拉下來合并git pull origin master --allow-unrelated-histories這里的--allow-unrelated-histories是明確告訴Git我知道兩邊歷史沒有共同祖先但請把它們強(qiáng)行合并。合并完會(huì)有一個(gè)commit記錄生成然后你再git push就通了。這個(gè)參數(shù)在很多合并場景里都有用比如你想把兩個(gè)本來獨(dú)立的項(xiàng)目合并成一個(gè)大項(xiàng)目時(shí)也必須加它。還有一個(gè)小坑是Windows用戶最容易碰到的推上去以后提示warning說“LF will be replaced by CRLF”。這是Windows換行符和Linux換行符不一致導(dǎo)致的。Git默認(rèn)在提交時(shí)會(huì)把CRLF轉(zhuǎn)換成LF在checkout時(shí)再轉(zhuǎn)換回來大多時(shí)候無傷大雅。如果你看著煩可以執(zhí)行一行配置git config --global core.autocrlf true這行配置讓Git在Windows上統(tǒng)一處理換行符避免在git diff時(shí)出現(xiàn)整行整行的“修改”假象。5. 納入日常開發(fā)commit、push、pull、分支合并全流程5.1 每天三次的“存錢罐”操作add、commit、push版本管理的日常其實(shí)特別簡單改代碼、存代碼、傳代碼。我把這套操作戲稱為“存錢罐流程”git add . # 1. 把當(dāng)前所有改動(dòng)放進(jìn)購物車 git commit -m 完成搜索頁面的前端交互 # 2. 結(jié)賬打包生成提交記錄 git push # 3. 把本次提交推到云端來自我的個(gè)人習(xí)慣不要一天改了一堆東西后唯一一次提交要盡量用小步提交。每完成一個(gè)功能點(diǎn)、每修完一個(gè)bug、每調(diào)整完一個(gè)樣式就提交一次。這樣當(dāng)某次改動(dòng)出了問題時(shí)你能用git log精準(zhǔn)定位到是哪次提交引入的問題然后把那一行g(shù)it revert回去。如果所有改動(dòng)都擠在一個(gè)大提交里回滾既困難又痛苦。關(guān)于提交頻率有一種糾結(jié)“代碼還沒寫完提交了會(huì)不會(huì)不好”不會(huì)的。提交只是記錄當(dāng)前狀態(tài)不是發(fā)布。你可以提交幾百次草稿狀態(tài)最終只把需要的內(nèi)容合并到正式分支。Git的世界里提交是廉價(jià)的、頻繁的、安全的只要你提交信息寫得清楚不會(huì)有任何負(fù)面影響。還有一句經(jīng)驗(yàn)之談?wù)垊?wù)必養(yǎng)成寫完代碼立刻提交的習(xí)慣尤其是當(dāng)你準(zhǔn)備去開會(huì)、去吃飯、甚至只是去喝口水的時(shí)候。我發(fā)生過不止一次下午改了一堆內(nèi)容忘了提交晚上電腦死機(jī)強(qiáng)制重啟看到的還是上午的代碼。那種欲哭無淚的感覺體驗(yàn)一次就夠了。5.2 本地和云端不同步了怎么辦pull的正確姿勢多人協(xié)作或者多設(shè)備工作時(shí)光知道push不夠還要知道pull。push是把本地推送到云端pull是把云端的改動(dòng)拉下來。你的日常工作流應(yīng)該是git pull # 同步最新代碼 git add . git commit -m 我的改動(dòng) git push這里有個(gè)經(jīng)典次序問題是先pull再改還是先commit再pull我的建議是動(dòng)手改代碼之前先pull一次確保你在最“新”的代碼基礎(chǔ)上開始改完之后commit然后push前再pull一次避免云端有別人剛推的新內(nèi)容導(dǎo)致沖突。如果pull之后發(fā)現(xiàn)云端和本地改動(dòng)了同一個(gè)文件的同一個(gè)位置Git會(huì)報(bào)告沖突并用這些標(biāo)記在文件里告訴你沖突雙方各自的內(nèi)容。處理辦法就是打開文件手動(dòng)決定保留哪邊或兩邊都要然后刪掉那些標(biāo)記行再重新git add、git commit完成合并。這個(gè)過程會(huì)在下面分支合并部分重點(diǎn)展開。5.3 分支多人協(xié)作的真正武器前面我們一直用的是默認(rèn)分支master有些平臺(tái)默認(rèn)命名為main區(qū)別只是名稱。一個(gè)人開發(fā)時(shí)直接在master上干活沒問題。但當(dāng)你需要同時(shí)開發(fā)兩個(gè)功能或者和同事在同一個(gè)項(xiàng)目里改動(dòng)不同模塊時(shí)一直共用一條分支就會(huì)各種混亂。分支的作用是給你一條獨(dú)立的代碼線在這個(gè)線里你隨便改、隨便提交、搞壞了也不會(huì)影響主線的穩(wěn)定。創(chuàng)建一個(gè)分支并切換過去的命令是git checkout -b feature/login這行命令等價(jià)于兩條命令git branch feature/login新建分支git checkout feature/login切換分支。Git分支的切換速度幾乎是瞬時(shí)的因?yàn)楸举|(zhì)上只是移動(dòng)了一個(gè)指針。在分支上完成開發(fā)后需要把改動(dòng)合并回主分支。經(jīng)典流程如下git checkout master # 切回主分支 git pull # 先拉最新代碼 git merge feature/login # 合并功能分支 git push # 推送合并結(jié)果如果合并過程中沒有沖突Git會(huì)直接生成一個(gè)“合并提交”一切順利。如果出現(xiàn)沖突前面說的沖突標(biāo)記方法同樣適用。我個(gè)人建議在合并分支之前先把feature/login分支做完最后提交再切回master去合并這樣混在沖突里的信息量最小容易判斷。5.4 分支合并沖突的實(shí)戰(zhàn)案例分析來一個(gè)我真實(shí)遇到過的場景我和同事同時(shí)在修一個(gè)Python包管理相關(guān)的工具函數(shù)。我改的是函數(shù)第三行的默認(rèn)參數(shù)值他改的是函數(shù)第五行的返回邏輯。我們各自的提交都沒問題但合并時(shí)Git傻眼了它不知道同時(shí)改動(dòng)第三行和第五行到底算不算沖突——因?yàn)閮尚卸疾辉谕粋€(gè)位置所以Git能自動(dòng)合并成功。這就要強(qiáng)調(diào)一個(gè)概念“內(nèi)容級合并”和“文件級合并”的區(qū)別。當(dāng)沖突真的發(fā)生時(shí)你打開文件會(huì)看到類似這樣的結(jié)構(gòu) HEAD return retries 1 return max(retries, 3) feature/loginHEAD代表你當(dāng)前所在分支的版本feature/login代表你正在合并進(jìn)來的分支版本。我的處理建議先看懂兩邊的代碼意圖再?zèng)Q定怎么合并。如果兩個(gè)改動(dòng)都該保留你可以把標(biāo)記刪掉寫一個(gè)綜合性的版本。處理完后在終端執(zhí)行g(shù)it add標(biāo)記為已解決再git commit完成本次合并。不要在沖突狀態(tài)中直接關(guān)掉編輯器不提交這會(huì)讓多個(gè)文件處于半合并狀態(tài)后面排查起來更頭疼。6. 高頻場景實(shí)戰(zhàn)IDE、多版本Python和命令行之外的玩法6.1 用IDEA新創(chuàng)建項(xiàng)目并直接拉取Git很多讀者不用純命令行干活平時(shí)都在IntelliJ IDEA、WebStorm這類IDE里寫代碼。好消息是這些IDE內(nèi)置了Git支持可以做到圖形化操作。場景一你已經(jīng)有一個(gè)遠(yuǎn)端倉庫現(xiàn)在想在新電腦上把項(xiàng)目拉下來。打開IDEA在歡迎頁選擇“Get from VCS”粘貼倉庫地址選擇本地存放目錄點(diǎn)擊CloneIDEA會(huì)自動(dòng)幫你把項(xiàng)目下載并識(shí)別出這是一個(gè)Git倉庫。之后你點(diǎn)工具欄上的綠色向下箭頭就是pull點(diǎn)藍(lán)色向上箭頭就是push改動(dòng)文件會(huì)直接顯示在側(cè)邊欄右側(cè)Diff窗口可以逐行查看改了什么。場景二在IDEA里創(chuàng)建新項(xiàng)目后想推送到云端。先創(chuàng)建一個(gè)空倉庫這個(gè)步驟在網(wǎng)頁端完成方法和前面一樣然后回到IDEA選擇VCS菜單和Share project on Gitee或者Share project on GitHub類似的操作項(xiàng)按提示關(guān)聯(lián)即可。如果你更喜歡命令行也可以在項(xiàng)目目錄下執(zhí)行g(shù)it init再git remote add origin完全走命令行的流程。這里我特別想提醒一句IDE自帶的Git插件雖然友好但新手在IDE里遇到“merge conflict彈窗”時(shí)更容易發(fā)懵。IDEA顯示沖突時(shí)會(huì)給三個(gè)選項(xiàng)Accept Yours、Accept Theirs、Merge。前兩個(gè)是單方面保留第三個(gè)是手動(dòng)合并。我強(qiáng)烈建議用第三個(gè)Merge選項(xiàng)左側(cè)右兩側(cè)分別是兩個(gè)版本中間是合并結(jié)果看著更清晰也更不容易選錯(cuò)。6.2 當(dāng)Git遇上Python多版本管理“Python多版本管理”在熱搜詞里經(jīng)常和Git一起出現(xiàn)因?yàn)楹芏嚅_發(fā)者用Python寫自動(dòng)化腳本或爬蟲項(xiàng)目系統(tǒng)Python版本又不太可控。舉個(gè)例子你電腦上同時(shí)有Python3.8和Python3.11舊項(xiàng)目依賴3.8環(huán)境新項(xiàng)目想在3.11上跑。這種情況下正確的做法是用pyenv這類版本管理工具而不是每次手動(dòng)改PATH。Git在這里的角色是什么呢你的虛擬環(huán)境列表不要提交到Git里但Python項(xiàng)目代碼要。這就涉及一個(gè)非常重要的配置文件.gitignore。在項(xiàng)目的根目錄下創(chuàng)建這個(gè)文件寫入以下幾行典型內(nèi)容__pycache__/ *.pyc venv/ .env.gitignore的作用是告訴Git這些路徑和文件不需要被版本控制。否則你push上去的倉庫會(huì)包含一大堆緩存文件和本地虛擬環(huán)境路徑既不干凈還可能把本機(jī)絕對路徑泄露給別人。這就是為什么很多開源Python項(xiàng)目的倉庫里都有一個(gè)非常齊全的.gitignore模板里面覆蓋了__pycache__、.pytest_cache、.idea、dist、build等常見生產(chǎn)和IDE產(chǎn)物。多版本Python環(huán)境下還有一個(gè)Git相關(guān)的好習(xí)慣在README里寫清楚“Python版本要求”和“安裝依賴的命令”。像requirements.txt和pyproject.toml這類依賴清單文件必須提交進(jìn)倉庫因?yàn)樗鼈冇涗浟隧?xiàng)目的運(yùn)行環(huán)境依賴。配合Git的分支你還可以維護(hù)一個(gè)python3.8分支和一個(gè)python3.11分支用兩套依賴做兼容性驗(yàn)證——這些都是版本管理帶來的額外優(yōu)勢。6.3 團(tuán)隊(duì)協(xié)作里的.gitignore與提交規(guī)范說句實(shí)在話團(tuán)隊(duì)協(xié)作項(xiàng)目真正考驗(yàn)人的往往不是分支合并而是亂七八糟的提交。為了讓代碼歷史不亂我配合過的團(tuán)隊(duì)大多約定了一套“提交信息規(guī)范”使用feat表示新增功能、fix表示修復(fù)bug、docs表示文檔變更、refactor表示重構(gòu)。比如fix: 修復(fù)登錄態(tài)過期后跳轉(zhuǎn)錯(cuò)誤。這種規(guī)范配合GitHub和Gitee上的PRPull Request功能能極大提升代碼審查效率。.gitignore在團(tuán)隊(duì)場景里更是重中之重。建議項(xiàng)目初始化時(shí)就讓所有成員共用同一份模板并且第一時(shí)間提交。如果我在review時(shí)發(fā)現(xiàn)有同事把本地的.idea配置或node_modules提交了我會(huì)直接指出這是給整個(gè)倉庫埋雷。因?yàn)槊總€(gè)開發(fā)者的IDE配置都可能不同node_modules又動(dòng)輒幾百M(fèi)B提交進(jìn)Git會(huì)讓每次clone和pull都痛苦不堪。7. 實(shí)用命令速查表貼墻版每次給學(xué)員培訓(xùn)完他們都會(huì)問老師有沒有一張表能放在桌面上看這里我把高頻命令分類整理好建議直接保存或打印操作場景命令含義查看狀態(tài)git status查看工作區(qū)當(dāng)前的改動(dòng)和暫存情況查看歷史git log --oneline一行式顯示提交歷史暫存所有改動(dòng)git add .把所有改動(dòng)放入暫存區(qū)提交git commit -m 說明生成一條提交記錄推送git push推送到遠(yuǎn)程分支拉取git pull拉取遠(yuǎn)程更新并合并新建分支git checkout -b 分支名創(chuàng)建并切換分支切換分支git checkout 分支名切換現(xiàn)有分支合并分支git merge 分支名把指定分支合并到當(dāng)前分支查看遠(yuǎn)程git remote -v查看關(guān)聯(lián)的遠(yuǎn)程倉庫地址回退上一個(gè)提交git revert HEAD用新提交反向撤銷上一個(gè)提交放棄本地改動(dòng)git checkout -- 文件名恢復(fù)到暫存區(qū)的版本這里特別解釋一下git revert和git reset的區(qū)別。git revert會(huì)新生成一個(gè)提交來抵消之前的提交歷史是向前推進(jìn)的適合多人協(xié)作分支git reset則是把指針直接撥回某個(gè)提交會(huì)改變歷史在已推送的公共分支上使用需要非常謹(jǐn)慎。新手期我用git reset把同事的提交搞丟過一次從此只學(xué)會(huì)了“凡已推送必用revert”。8. 我踩過的坑和現(xiàn)在的習(xí)慣最后分享一點(diǎn)掏心窩的東西。接觸Git這幾年我最深的體會(huì)是大部分災(zāi)難性事故其實(shí)不是Git的錯(cuò)是“時(shí)機(jī)”和“習(xí)慣”的錯(cuò)。比如在代碼改動(dòng)還未提交的時(shí)候強(qiáng)行切換到其他分支你的改動(dòng)會(huì)跟著工作區(qū)一起過去導(dǎo)致新分支里出現(xiàn)了不屬于它的代碼再比如深夜加班、精神恍惚時(shí)執(zhí)行了git checkout .把你一天的工作瞬間原地清零。這些坑沒人告訴你你就得自己踩一遍。我現(xiàn)在的習(xí)慣是每天開工先git pull每完成一個(gè)小任務(wù)就git commit每天下班前必git push重大改動(dòng)前確保已有一次commit絕不在有未提交改動(dòng)時(shí)切分支任何人在公共分支上只準(zhǔn)用git revert不準(zhǔn)無腦git reset。這套習(xí)慣幫我擋掉了無數(shù)次“靈異事件”也讓團(tuán)隊(duì)協(xié)作變得異常清爽。如果你剛看完這篇教程我建議你馬上做的事就是打開命令行執(zhí)行g(shù)it --version確認(rèn)環(huán)境然后去Gitee建第一個(gè)私有倉庫把你手上最想保護(hù)好的一份代碼推上去。說真的你只需要完成第一次push剩下的所有高級功能都會(huì)順著流程自然遇到、自然學(xué)會(huì)。那個(gè)從“壓縮包版本地獄”里解脫出來的運(yùn)營切入口就在你敲下git push -u origin master這一行字符的瞬間。祝你早日把版本庫變成你的時(shí)間機(jī)器把云端倉庫變成你的異地保險(xiǎn)柜。