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