1. 從“單打獨(dú)斗”到“團(tuán)隊協(xié)作”為什么你需要一個代碼倉庫如果你剛開始接觸編程或者一直習(xí)慣于在本地電腦上寫代碼那么“代碼倉庫”這個概念可能聽起來有點(diǎn)遙遠(yuǎn)。你可能會想“我的代碼就放在桌面上用記事本或者IDE打開就能寫為什么要搞那么復(fù)雜” 我剛開始的時候也是這么想的直到我第一次嘗試和別人一起修改同一個文件結(jié)果發(fā)現(xiàn)我覆蓋了他的修改他也覆蓋了我的最后誰也不知道哪個版本是對的項(xiàng)目直接癱瘓。那一刻我才明白一個可靠的代碼倉庫就像團(tuán)隊協(xié)作的“交通規(guī)則”和“時光機(jī)”它不是高級程序員的專屬而是任何希望代碼工作可持續(xù)、可協(xié)作的開發(fā)者必備的基礎(chǔ)設(shè)施。簡單來說一個代碼倉庫Repository 簡稱Repo就是一個專門用來存放和管理你的項(xiàng)目代碼、文檔等所有文件的地方。它最核心的能力是版本控制記錄每一次文件的修改誰、什么時候、改了哪里、為什么改并且可以隨時回退到任何一個歷史版本。想象一下寫論文如果沒有“撤銷”和“歷史版本”功能一旦誤刪了一段關(guān)鍵論證可能半天的工作就白費(fèi)了。代碼倉庫就是為你所有的代碼文件提供了無限次的“撤銷”和“歷史版本”功能。而“碼云”Gitee就是這樣一個提供代碼倉庫托管服務(wù)的國內(nèi)平臺。你可以把它理解為一個功能強(qiáng)大的“代碼網(wǎng)盤”但它遠(yuǎn)不止是存儲。它基于Git版本控制系統(tǒng)讓你可以輕松地進(jìn)行代碼的備份、版本管理、協(xié)作開發(fā)和持續(xù)集成。對于國內(nèi)的開發(fā)者來說碼云的優(yōu)勢非常明顯訪問速度快全中文界面社區(qū)活躍并且完美支持微信、釘釘?shù)葒鴥?nèi)常用賬號登錄降低了入門門檻。所以無論你是一個想備份自己學(xué)習(xí)項(xiàng)目的大學(xué)生一個需要和同事共同開發(fā)某個功能模塊的職場新人還是一個想開源自己小工具的個人開發(fā)者學(xué)會使用碼云或任何Git平臺都是你編程生涯中一項(xiàng)高性價比的投資。接下來我就以一個完整的項(xiàng)目為例帶你從零開始手把手走通碼云的核心使用流程。2. 前期準(zhǔn)備注冊賬號與安裝必備工具在開始“駕駛”之前我們需要先準(zhǔn)備好“駕照”和“車輛”。對于碼云來說就是賬號和Git工具。2.1 注冊碼云賬號這一步非常簡單訪問碼云官網(wǎng)點(diǎn)擊注冊。我強(qiáng)烈建議你使用手機(jī)號或者微信掃碼注冊。原因有二一是便于記憶和登錄二是后續(xù)很多操作如雙重驗(yàn)證、接收通知都離不開手機(jī)號。注冊時起一個容易辨認(rèn)的用戶名這將成為你未來在碼云社區(qū)的“ID”。完成注冊后建議立即在設(shè)置中綁定郵箱這樣能接收重要的倉庫動態(tài)通知。2.2 安裝與配置Git碼云網(wǎng)站是托管平臺而實(shí)際在本地操作版本控制命令的是Git這個工具。你需要先在本地電腦上安裝Git。對于Windows用戶直接前往Git官網(wǎng)下載安裝程序。安裝過程中有幾個選項(xiàng)需要注意選擇組件勾選“Git Bash Here”和“Git GUI Here”這會在你的右鍵菜單中添加快捷方式。選擇默認(rèn)編輯器如果你不熟悉Vim建議選擇“Use Visual Studio Code as Gits default editor”或你熟悉的編輯器如Notepad。這會在你提交代碼需要寫說明時用更友好的編輯器打開。調(diào)整PATH環(huán)境選擇“Git from the command line and also from 3rd-party software”。這會將Git命令添加到系統(tǒng)環(huán)境變量讓你能在任意命令行窗口中使用。配置行尾轉(zhuǎn)換選擇“Checkout Windows-style, commit Unix-style line endings”。這是為了確保在不同操作系統(tǒng)間協(xié)作時換行符不會引起混亂。對于macOS用戶更簡單打開終端Terminal輸入命令xcode-select --install安裝命令行工具其中就包含了Git?；蛘呤褂肏omebrew安裝brew install git。安裝完成后打開終端Windows用戶可以用剛安裝的“Git Bash”我們需要進(jìn)行最關(guān)鍵的一次性的全局配置告訴Git你是誰git config --global user.name 你的碼云用戶名 git config --global user.email 你注冊碼云時綁定的郵箱這兩條命令非常重要。你未來每一次代碼提交Commit都會帶上這個作者信息。它就像是你的“數(shù)字簽名”保證了每一次修改的可追溯性。你可以通過git config --global --list命令來檢查配置是否成功。3. 核心工作流實(shí)戰(zhàn)從本地項(xiàng)目到碼云倉庫現(xiàn)在假設(shè)我們有一個本地項(xiàng)目叫做my-awesome-project里面已經(jīng)有一些代碼文件了。我們的目標(biāo)是將它托管到碼云上并進(jìn)行一次完整的更新流程。3.1 在碼云上創(chuàng)建遠(yuǎn)程倉庫首先我們需要在碼云上建立一個“空房子”來存放我們的代碼。登錄碼云點(diǎn)擊頁面右上角的 “” 號選擇 “新建倉庫”。倉庫名稱填寫my-awesome-project通常與本地項(xiàng)目名一致便于管理。路徑會自動根據(jù)倉庫名生成保持默認(rèn)即可。介紹簡單寫一句比如“我的第一個碼云項(xiàng)目用于學(xué)習(xí)Git工作流”。倉庫設(shè)置公開/私有學(xué)習(xí)階段可以選擇“公開”這樣別人能看到你的代碼但無法直接修改。如果是公司私有項(xiàng)目務(wù)必選擇“私有”。初始化倉庫這里有一個關(guān)鍵選擇。因?yàn)槲覀儽镜匾呀?jīng)有項(xiàng)目文件了所以不要勾選“使用Readme文件初始化這個倉庫”。如果你勾選了碼云會先創(chuàng)建一個帶有README文件的倉庫這會導(dǎo)致你后續(xù)將本地倉庫與之關(guān)聯(lián)時產(chǎn)生沖突需要多一步合并操作。對于從本地已有項(xiàng)目開始的場景保持所有初始化選項(xiàng)為空是最干凈的做法。設(shè)置模板忽略。分支模型選擇“單分支模型僅master分支”。對于新手從單一主分支開始理解流程是最清晰的。點(diǎn)擊“創(chuàng)建”一個空的遠(yuǎn)程倉庫就誕生了。創(chuàng)建成功后頁面會顯示倉庫的HTTPS地址格式如https://gitee.com/你的用戶名/my-awesome-project.git。復(fù)制這個地址稍后會用到。3.2 將本地項(xiàng)目初始化為Git倉庫并關(guān)聯(lián)遠(yuǎn)程現(xiàn)在回到我們的本地項(xiàng)目文件夾。打開終端或Git Bash使用cd命令導(dǎo)航到你的項(xiàng)目根目錄。cd /path/to/your/my-awesome-project將這個目錄初始化為一個Git管理的本地倉庫git init執(zhí)行后當(dāng)前目錄下會生成一個隱藏的.git文件夾所有版本控制信息都存儲在里面。將本地倉庫與我們剛才在碼云上創(chuàng)建的“空房子”遠(yuǎn)程倉庫關(guān)聯(lián)起來git remote add origin https://gitee.com/你的用戶名/my-awesome-project.git這里的origin是一個別名代表你添加的這個遠(yuǎn)程倉庫地址。你可以起別的名字但origin是約定俗成的默認(rèn)名。3.3 第一次提交與推送將本地代碼“搬家”到遠(yuǎn)程關(guān)聯(lián)好后我們需要把本地文件“打包”并“運(yùn)送”到遠(yuǎn)程倉庫。添加文件到暫存區(qū)Git的設(shè)計分為工作區(qū)、暫存區(qū)Stage/Index和倉庫。git add命令就是將工作區(qū)的改動添加到暫存區(qū)準(zhǔn)備打包。添加所有新文件和修改過的文件git add .注意最后有個點(diǎn)如果只想添加特定文件git add filename1 filename2創(chuàng)建提交將暫存區(qū)的內(nèi)容正式打包成一個版本并附上說明。git commit -m “初始化項(xiàng)目添加核心功能模塊”-m后面的信息是本次提交的說明務(wù)必認(rèn)真填寫。好的提交信息應(yīng)該簡潔明了地說明這次提交“做了什么”例如“修復(fù)了用戶登錄時密碼驗(yàn)證失敗的bug”、“新增了商品詳情頁的圖片輪播組件”。模糊的“更新代碼”或“fix bug”會給日后回溯歷史帶來巨大困難。推送到遠(yuǎn)程倉庫將本地打包好的版本提交推送到碼云origin的master分支。git push -u origin master-u參數(shù)是--set-upstream的簡寫它建立了本地master分支與遠(yuǎn)程origin/master分支的追蹤關(guān)系。設(shè)置好后下次在這個分支上只需要輸入git push即可。完成這三步后刷新你的碼云倉庫頁面就能看到所有代碼文件都已經(jīng)安然無恙地出現(xiàn)在線上了。至此你的代碼就有了一個安全的遠(yuǎn)程備份。4. 日常開發(fā)循環(huán)修改、提交、推送與拉取項(xiàng)目不是一次上傳就結(jié)束的日常開發(fā)是一個持續(xù)的循環(huán)。假設(shè)過了一天你修改了index.html文件并新增了一個style.css文件。4.1 查看狀態(tài)與差異在動手add和commit之前先養(yǎng)成查看狀態(tài)的習(xí)慣。git status查看哪些文件被修改了紅色哪些文件在暫存區(qū)綠色。它能給你一個清晰的當(dāng)前工作目錄快照。git diff查看具體修改了哪些內(nèi)容。git diff filename可以查看指定文件的具體行級改動。這能幫你確認(rèn)修改是否符合預(yù)期避免提交錯誤的代碼。4.2 完成一次更新推送確認(rèn)無誤后重復(fù)“添加-提交-推送”流程git add . # 將 index.html 的修改和新的 style.css 添加到暫存區(qū) git commit -m “優(yōu)化首頁布局并添加樣式文件” git push # 由于之前用了 -u這里直接 push 即可4.3 獲取他人的更新拉取Pull在團(tuán)隊協(xié)作中別人也可能向同一個倉庫推送了代碼。在你開始新一天的工作或者準(zhǔn)備推送自己的代碼前務(wù)必先拉取遠(yuǎn)程的最新更改以避免沖突。git pull origin master這條命令相當(dāng)于執(zhí)行了git fetch獲取遠(yuǎn)程更新和git merge將更新合并到本地當(dāng)前分支兩個動作。如果別人修改的文件和你本地修改的文件不同Git會自動合并。如果修改了同一文件的同一區(qū)域則會產(chǎn)生“沖突”Conflict需要手動解決。4.4 處理代碼沖突沖突是協(xié)作中的常態(tài)不用害怕。當(dāng)git pull后提示CONFLICT時Git會在沖突的文件里用標(biāo)記出沖突區(qū)域。例如 HEAD h1這是你本地修改的標(biāo)題/h1 h1這是遠(yuǎn)程倉庫上的標(biāo)題/h1 origin/masterHEAD到之間是你的修改到之間是別人的修改。你需要用編輯器打開這個文件手動決定保留哪一部分或者進(jìn)行整合。比如你可以改成h1這是我們整合后的新標(biāo)題/h1。刪除所有沖突標(biāo)記,,。解決完所有沖突文件后執(zhí)行g(shù)it add .將解決后的文件標(biāo)記為已解決。最后執(zhí)行g(shù)it commit。Git會為你自動生成一個合并提交的信息你也可以修改它。完成提交后執(zhí)行g(shù)it push將合并后的結(jié)果推送到遠(yuǎn)程。注意養(yǎng)成“勤提交、早拉取”的習(xí)慣。將大的功能拆分成多個小提交每次完成一個邏輯完整的改動就提交一次。在開始編碼前和推送前都先拉取一下最新代碼能極大降低遇到復(fù)雜沖突的概率。5. 分支管理開發(fā)新功能的“安全沙盒”直接在master分支上開發(fā)新功能是危險的尤其是未經(jīng)驗(yàn)證的功能可能會弄壞線上穩(wěn)定的代碼。分支Branch就是為了解決這個問題而生的。你可以把分支想象成一條從主時間線master分叉出去的平行時間線你在分支上的所有實(shí)驗(yàn)都不會影響主時間線。5.1 創(chuàng)建與切換分支假設(shè)我們要開發(fā)一個“用戶評論”功能?；诋?dāng)前分支通常是master創(chuàng)建一個新分支git branch feature-user-comment # 創(chuàng)建名為 feature-user-comment 的分支或者使用更常用的創(chuàng)建并切換分支的命令git checkout -b feature-user-comment # 創(chuàng)建并立即切換到該分支git checkout -b是標(biāo)準(zhǔn)做法。在Git較新版本中也推薦使用git switch -c feature-user-comment語義更清晰。使用git branch命令可以查看所有分支當(dāng)前所在分支前會有一個*號。5.2 在新分支上獨(dú)立開發(fā)現(xiàn)在你可以在feature-user-comment分支上放心地修改代碼、進(jìn)行提交所有的操作都只存在于這個分支上。你可以按照add - commit - push的流程將分支推送到碼云git push -u origin feature-user-comment # 首次推送分支同樣使用 -u 建立追蹤在碼云倉庫頁面的分支下拉列表中就能看到這個新分支了。5.3 合并分支與拉取請求Pull Request當(dāng)功能開發(fā)并測試完畢我們希望能將它合并回主分支master。首先切換回master分支并拉取最新的代碼git switch master # 或 git checkout master git pull origin master然后將特性分支合并進(jìn)來git merge feature-user-comment如果合并順利功能就被整合到本地master分支了。最后git push即可。然而在團(tuán)隊協(xié)作中直接使用git merge并不是最佳實(shí)踐。更規(guī)范、更安全的方式是使用拉取請求Pull Request 簡稱PR 碼云中稱為“合并請求”。操作流程你將feature-user-comment分支推送到碼云后在倉庫頁面會提示你可以“創(chuàng)建合并請求”。點(diǎn)擊進(jìn)入選擇源分支你的特性分支和目標(biāo)分支通常是master。核心價值PR提供了一個代碼評審Code Review的平臺。團(tuán)隊成員可以在PR頁面上查看你的所有代碼改動逐行評論、提出建議。你可以根據(jù)反饋在分支上繼續(xù)修改并推送PR會自動更新。經(jīng)過討論和評審后由項(xiàng)目負(fù)責(zé)人點(diǎn)擊“合并”按鈕來完成集成。這個過程保證了代碼質(zhì)量也是知識共享的重要環(huán)節(jié)。合并后操作遠(yuǎn)程分支合并后你本地的master分支需要拉取更新git pull。同時可以考慮刪除已經(jīng)合并的特性分支保持倉庫整潔git branch -d feature-user-comment # 刪除本地分支 git push origin --delete feature-user-comment # 刪除遠(yuǎn)程分支6. 進(jìn)階技巧與碼云特色功能掌握了基本工作流你已經(jīng)能應(yīng)對90%的日常開發(fā)場景。下面這些技巧和功能則能讓你的協(xié)作更高效。6.1 .gitignore文件讓倉庫保持干凈項(xiàng)目中總有些文件不需要納入版本控制比如IDE的配置文件.idea/,.vscode/、依賴庫文件夾node_modules/,vendor/、編譯產(chǎn)物、本地環(huán)境配置文件包含密碼等敏感信息等。將這些文件提交到倉庫會帶來混亂和安全風(fēng)險。.gitignore文件就是用來指定哪些文件或目錄應(yīng)該被Git忽略。你需要在項(xiàng)目根目錄創(chuàng)建這個文件。碼云在創(chuàng)建倉庫時提供了常見語言如Java, Python, Node.js的.gitignore模板你可以直接選擇。也可以自己編寫語法如下# 忽略所有 .log 文件 *.log # 忽略 node_modules 目錄及其下所有內(nèi)容 node_modules/ # 忽略 build 目錄 build/ # 但不要忽略 lib/build/ 目錄下的重要文件 !lib/build/important.lib # 忽略當(dāng)前目錄下的 config.ini 文件 /config.ini創(chuàng)建并配置好.gitignore后再執(zhí)行g(shù)it add .和commit被忽略的文件就不會被跟蹤了。最佳實(shí)踐是在項(xiàng)目初始化后就創(chuàng)建這個文件。6.2 使用SSH密鑰實(shí)現(xiàn)免密推送每次推送都要輸入碼云賬號密碼很麻煩而且HTTPS方式在某些網(wǎng)絡(luò)下可能不穩(wěn)定。配置SSH密鑰可以實(shí)現(xiàn)安全且免密的身份認(rèn)證。生成密鑰對在本地終端運(yùn)行ssh-keygen -t ed25519 -C “你的郵箱”一路回車使用默認(rèn)路徑和空密碼即可。這會在用戶目錄下的.ssh文件夾中生成兩個文件id_ed25519私鑰絕不可泄露和id_ed25519.pub公鑰。添加公鑰到碼云用文本編輯器打開id_ed25519.pub文件復(fù)制全部內(nèi)容。登錄碼云進(jìn)入“設(shè)置” - “SSH公鑰”將內(nèi)容粘貼進(jìn)去標(biāo)題自擬點(diǎn)擊“確定”。測試連接在終端運(yùn)行ssh -T gitgitee.com如果看到 “Hi XXX! Youve successfully authenticated...” 的歡迎信息即表示成功。修改遠(yuǎn)程倉庫地址將你本地倉庫的遠(yuǎn)程地址從HTTPS改為SSH格式。git remote set-url origin gitgitee.com:你的用戶名/倉庫名.git之后再進(jìn)行g(shù)it push或git pull就不再需要輸入密碼了。6.3 碼云的實(shí)用協(xié)作功能Issues議題用于任務(wù)管理、Bug追蹤、功能建議。你可以為每個Bug或新功能創(chuàng)建一個Issue分配負(fù)責(zé)人關(guān)聯(lián)相關(guān)的提交或合并請求。它是項(xiàng)目管理的輕量級中心。Wiki項(xiàng)目的文檔中心。適合存放項(xiàng)目說明、安裝指南、API文檔、設(shè)計思路等。用Markdown編寫結(jié)構(gòu)清晰。Webhook網(wǎng)絡(luò)鉤子與持續(xù)集成這是一個高級功能。你可以配置Webhook當(dāng)倉庫發(fā)生推送、合并請求等事件時碼云會自動向一個你指定的URL通常是你的CI/CD服務(wù)器如Jenkins發(fā)送通知觸發(fā)自動化構(gòu)建、測試、部署流程。這對于實(shí)現(xiàn)DevOps至關(guān)重要。Pages服務(wù)碼云提供了靜態(tài)頁面托管服務(wù)Gitee Pages。你可以將倉庫中的HTML、CSS、JavaScript等靜態(tài)文件直接部署成一個可公開訪問的網(wǎng)站非常適合項(xiàng)目演示、個人博客或文檔站。從在本地孤零零地寫代碼到將代碼安全地托管在碼云上再到利用分支、PR進(jìn)行高效的團(tuán)隊協(xié)作這個過程是現(xiàn)代軟件開發(fā)的標(biāo)準(zhǔn)姿勢。它帶來的不僅僅是代碼的安全更是一種可追溯、可協(xié)作、工業(yè)化的開發(fā)習(xí)慣。剛開始接觸Git命令可能會覺得有些繁瑣但請相信我一旦你熟悉了status,add,commit,push,pull,checkout這幾個核心命令并將其融入你的肌肉記憶你會發(fā)現(xiàn)它帶來的秩序感和安全感是無可替代的。不妨現(xiàn)在就找一個你的本地小項(xiàng)目按照上面的步驟親手把它推到碼云上完成你的第一次“代碼搬家”和“功能分支開發(fā)”實(shí)戰(zhàn)永遠(yuǎn)是學(xué)習(xí)的最佳路徑。