Learn Git Branching

1Git 基礎使用流程

1.1初始化與克隆

# 初始化本地倉庫
git init# 克隆遠程倉庫
git clone <repo_url>

一般拉取代碼，直接在文件夾界面打開bash，git clone就行了?

1.2日常開發流程

1拉取最新代碼

git pull origin <branch_name>

分支名，拉取遠程某個分支代碼?

2創建/切換分支

git checkout -b <branch_name>

創建一個新的分支同時切換到新創建的分支

3添加修改文件

git add <file_name>  # 添加單個文件
git add .            # 添加所有改動

4提交代碼

git commit -m "符合規范的提交信息"

5推送代碼

git push origin <branch_name>

2.代碼提交規范

2.1提交前檢查

●通過 git diff 確認改動內容
●確保通過代碼檢查工具（如 ESLint）
●避免提交調試日志、臨時文件（如 .idea/）

2.2提交粒度

●原子性提交：每個提交應僅包含一個功能/修復的完整改動
●避免巨型提交：單次提交建議不超過 300 行代碼

2.3merge request（合并請求）

保護分支（如：master），禁止直接push。開發同學提交代碼至自己分支之后，創建mr由對應倉庫管理員進行review后再合入。

3分支命名規范

3.1分支類型前綴

類型	前綴	示例
功能開發	feature/	feature/user-login
Bug 修復	bugfix/	bugfix/login-error
發布分支	release/	release/v1.2.0
熱修復	hotfix/	hotfix/db-connection
文檔	docs/	docs/api-update

3.2命名規則

●全小寫，單詞用連字符分隔
●包含關聯的 Issue ID（可選）：feature/123-add-search

4Commit Message 規范

4.1格式要求

<type>[optional scope]: <description>[optional body][optional footer]

4.2提交類型

類型	說明
feat	新功能
fix	Bug 修復
docs	文檔更新
style	代碼格式調整（不影響邏輯）
refactor	代碼重構
test	測試相關
chore	構建/依賴更新

4.3示例

git commit -m "feat(auth): implement OAuth2 login- Add Google OAuth integration
- Update user schema with social IDsCloses #123"

5最佳實踐與工具

5.1推薦實踐

●主分支（main）保護：禁止直接 push，必須通過 PR
●使用 rebase 替代 merge 保持提交歷史整潔
●定期執行 git gc 清理倉庫

5.2輔助工具

●Commitizen: 交互式提交引導工具
●commitlint: Commit Message 校驗
●Husky: Git 鉤子管理
●Git Flow: 分支管理擴展工具