對于一個新項目,從 Git 倉庫拉取 test_tool
分支并進行后續修改提交的完整流程如下:
一、首次拉取項目(克隆倉庫并切換分支)
-
克隆遠程倉庫到本地
打開終端(或 PyCharm 的 Terminal),進入你想存放項目的目錄,執行:# 克隆整個倉庫(會下載所有分支的信息,但默認在主分支) git clone https://gitlab.****com/test/test_tool.git
-
進入項目目錄
cd test_tool # 進入克隆下來的項目文件夾
-
切換到
test_tool
分支git checkout test_tool
- 如果分支不存在本地(首次拉取可能如此),會自動創建并關聯遠程分支,提示:
Branch 'test_tool' set up to track remote branch 'test_tool' from 'origin'.
- 如果分支不存在本地(首次拉取可能如此),會自動創建并關聯遠程分支,提示:
二、日常修改與提交流程
當你對項目文件進行修改后,按以下步驟提交到遠程:
-
查看修改內容
確認自己修改了哪些文件:git status # 查看工作區狀態(紅色文件為未暫存的修改) git diff # 查看具體修改的代碼內容(可選)
-
將修改添加到暫存區
# 添加單個文件(推薦,精確控制提交內容) git add 文件名 # 例如:git add src/main.py# 或添加所有修改(謹慎使用,確保只提交需要的內容) git add .
-
提交到本地倉庫
填寫清晰的提交說明(描述修改目的):git commit -m "修改說明" # 例如:git commit -m "修復數據解析錯誤"
-
拉取遠程最新代碼(避免沖突)
提交前先同步遠程的最新更新(防止他人修改與你的修改沖突):git pull # 因為已關聯遠程分支,直接拉取即可
- 若拉取時出現沖突,需手動解決(沖突文件會標記
<<<<<<<
等符號),解決后執行:
git add .
→git commit -m "解決沖突"
- 若拉取時出現沖突,需手動解決(沖突文件會標記
-
推送到遠程分支
將本地提交推送到遠程test_tool
分支:git push # 已關聯分支,直接推送
三、關鍵注意事項
-
分支關聯確認
執行git branch -vv
查看當前分支是否關聯origin/test_tool
,若未關聯:git branch --set-upstream-to=origin/test_tool test_tool
-
沖突處理原則
- 拉取后若有沖突,優先保留正確的代碼,刪除沖突標記(
<<<<<<<
、=======
、>>>>>>>
)。 - 沖突解決后必須提交一次(
git commit
)才能繼續推送。
- 拉取后若有沖突,優先保留正確的代碼,刪除沖突標記(
-
提交規范
- 每次提交只包含一個獨立功能或修復(避免大量修改堆積)。
- 提交說明簡潔明了(例如:“新增日志模塊”、“修復登錄超時問題”)。
按照以上流程,即可完成從拉取項目到日常開發提交的全流程,確保代碼與遠程倉庫同步且避免沖突。