Git 分支管理规范涵盖 master 与 dev 分支的核心流程。包括仓库初始化克隆或关联远程、dev 分支日常开发与提交、定期同步主分支更新。支持指定提交 cherry-pick 或整分支合并至 master，并提供冲突处理及代码回退操作指南。强调推送前必拉取、提交粒度控制及数据安全备份，确保团队协作顺畅。
本文整理了 Git 日常开发中涉及 master（主分支）和 dev（开发分支）的核心操作流程，包含仓库初始化、分支开发、代码合并、冲突处理、代码回退等关键场景。
# 克隆远程仓库到本地（自动创建本地仓库并关联远程）
git clone 远程仓库地址
# 示例：git clone https://github.com/用户名/仓库名.git
仓库名
# 本地初始化仓库
git init
# 添加文件并首次提交
git add .
# 暂存所有文件
git commit -m "首次提交：初始化项目"
# 关联远程仓库（远程仓库需提前在平台创建）
git remote add origin 远程仓库地址
# 首次拉取远程历史（若远程有内容，必须执行，否则推送报错）
git pull origin master --allow-unrelated-histories
# 仅首次需要
# 推送本地仓库到远程（-u 绑定上游分支，后续可直接 git push）
git push -u origin master
# 切换到本地 master 分支
git checkout master
# 拉取远程 master 最新代码
git pull origin master
# 切换到本地 dev 分支（若无则创建：git checkout -b dev）
git checkout dev
# 合并远程 master 到本地 dev（同步主分支更新）
git fetch origin master
git merge origin/master
# 查看文件状态（确认修改/新增文件）
git status
# 暂存修改（单个文件/所有文件）
git add 文件名
# 暂存单个文件
git add .
# 暂存所有修改（推荐）
# 提交到本地仓库（备注需清晰，仅包含单个功能点）
git commit -m "功能：完成 dev 分支 XX 模块开发"
# 首次推送 dev 分支到远程（-u 绑定上游）
git push -u origin dev
# 后续修改后推送（已绑定上游，直接推送）
git push
# 在 dev 分支中拉取并合并远程 master 最新代码
git pull origin master
# 若出现冲突（终端提示 "Automatic merge failed"）：
# 1. 打开冲突文件，删除冲突标记（<<<<<<< HEAD、=======、>>>>>>> origin/master）
# 2. 保留需要的内容，保存文件
# 3. 标记冲突已解决并提交
git add .
# 标记所有冲突文件已解决
git commit -m "合并 master 到 dev，解决 XX 模块冲突"
git push
# 推送到远程 dev 分支
适用于仅需合并 dev 分支中某一个提交（而非整个分支）的场景：
# 1. 切换到 master 分支并检查工作区
git checkout master
git status
# 2. 暂存 master 分支未提交的修改（若有）
git stash
# 3. 拉取远程 master 最新代码
git pull origin master
# 4. 查找 dev 分支中需要合并的提交哈希值
git checkout dev
git log --oneline -n 10
# 查看最近 10 条提交，复制目标哈希值（如 23919c9）
# 5. 切回 master 分支，执行 cherry-pick 合并指定提交
git checkout master
git cherry-pick 23919c9
# 6. 若 cherry-pick 出现冲突，解决后提交
git add .
git commit -m "cherry-pick：合并 dev 分支 23919c9 提交到 master"
# 7. 推送合并后的 master 到远程
git push origin master
# 8. 恢复 master 分支暂存的修改（若有）
git stash pop
# 9. 验证提交结果（确认指定提交已合并）
git log
# 查看提交历史
适用于 dev 分支功能开发完成，需整体合并到主分支的场景：
# 1. 切换到 master 分支并拉取最新
git checkout master
git pull origin master
# 2. 合并远程 dev 分支到本地 master
git merge origin/dev
# 3. 若出现冲突，解决后提交
git add .
# 标记冲突已解决
git commit -m "合并 dev 分支到 master，解决 XX 模块冲突"
# 4. 推送 master 到远程（可测试完成后推送）
git push origin master
# 5. 验证合并结果
git log
# 查看提交历史，确认 dev 分支代码已合并
若 dev 分支功能已完全合并到 master 且无需保留，可清理分支：
# 删除本地 dev 分支
git branch -d dev
# 删除远程 dev 分支（确认不再需要时执行）
git push origin --delete dev
需将本地指定文件回退到历史提交版本，并重新提交推送的场景：
# 1. 回退指定文件到历史提交版本（替换哈希值和文件路径）
git restore --source=054f3b -- backend/app/api/v1/module_visualization/service.py
# 2. 暂存回退后的文件
git add backend/app/api/v1/module_visualization/service.py
# 3. 提交回退操作
git commit -m "回退：将 XX 文件恢复到 054f3b 版本"
# 4. 拉取远程最新代码（避免推送冲突）
git pull origin dev
# 若操作的是 dev 分支
# 5. 推送回退后的代码到远程
git push origin dev
无论推送到 master 还是 dev 分支，推送前必须执行 git pull origin 分支名，确保本地与远程同步，避免推送被拒绝（rejected 错误）。
git commit 标记状态，推送可延后（如测试完成后）。git stash 暂存未提交修改，合并完成后通过 git stash pop 恢复。冲突文件中会出现以下标记，需全部删除：
<<<<<<< HEAD （本地分支的代码）
=======
>>>>>>> origin/master
git add . 标记冲突已解决；git commit 提交（备注需说明'解决 XX 冲突'）；
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online