GitFlow 是一套标准化的 Git 分支管理流程，涵盖 master、develop、feature、release、hotfix 五类分支。提供从零初始化仓库到功能开发、版本发布及紧急修复的全流程命令指南，包含 SSH/Token 认证配置、分支合并策略及通用辅助命令，帮助开发者规范协作流程，确保代码版本可控。
GitFlow 是一套标准化的 Git 分支管理流程，核心围绕 master（生产分支）、develop（开发分支）、feature（功能分支）、release（发布分支）、（紧急修复分支）五类分支展开。
hotfix以下是从仓库初始化到生产发布的全流程命令，无冗余文字，直接复制可用。
# 创建项目目录并进入
mkdir project-name && cd project-name
# 初始化 Git 仓库
git init
# 关联远程仓库（替换为你的远程地址）
git remote add origin [email protected]:xxx/project-name.git
# 首次提交并推送到 master
touch README.md && git add . && git commit -m "init: 初始化仓库"
git push -u origin master
当你首次配置仓库时，需要配置密钥，以下是首次创建项目时，不同认证方式的触发时机 + 核心命令，直接对应场景使用：
| 认证方式 | 触发时机 | 适用场景 |
|---|---|---|
| SSH 密钥 | 配置后，首次 git push/pull 远程仓库时 | 长期使用（免重复输入密码） |
| 个人令牌（Token） | 无 SSH 时，首次 git push 输入账号后替代密码 | 临时/无 SSH 权限场景 |
| 账号密码 | 无 SSH/Token 时，首次 git push 弹窗/命令行提示 | 仅临时测试（不推荐） |
首次关联远程仓库（git remote add origin）后执行 git push 时，若未配置 SSH，会提示权限拒绝，需先配置 SSH 密钥。
# 1. 生成 SSH 密钥（替换为你的邮箱，一路回车默认即可）
ssh-keygen -t ed25519 -C "[email protected]"
# 2. 查看并复制 SSH 公钥（复制输出的全部内容）
# Mac/Linux
cat ~/.ssh/id_ed25519.pub
# Windows（PowerShell）
type $HOME/.ssh/id_ed25519.pub
# 3. 登录 Git 平台（GitHub/GitLab/Gitee）添加公钥
# 路径：个人设置 → SSH and GPG keys → New SSH key → 粘贴公钥保存
# 4. 验证 SSH 连接（替换为对应平台域名）
ssh -T [email protected] # GitHub
ssh -T [email protected] # Gitee
ssh -T [email protected] # GitLab
# 5. 验证成功后，执行首次 push（免密）
git push -u origin master
未配置 SSH，执行 git push -u origin master 后，命令行弹出'输入用户名密码'时，密码框输入 Token 而非真实密码。
# 1. 先执行首次 push，触发账号输入
git push -u origin master
# 2. 命令行提示输入时：
# 用户名：输入 Git 平台账号（如 GitHub 用户名/邮箱）
# 密码：输入提前生成的个人令牌（Token）
# 【可选】保存 Token 到凭据管理器（免重复输入）
# Windows
git config --global credential.helper wincred
# Mac
git config --global credential.helper osxkeychain
# Linux
git config --global credential.helper store
Token 生成步骤（以 GitHub 为例）
登录 GitHub → 头像 → Settings → Developer settings → Personal access tokens → Generate new token；勾选权限（至少
repo）→ 生成 Token（仅显示一次，务必复制保存）。
未配置 SSH/Token，执行 git push -u origin master 后，命令行/弹窗提示输入'用户名 + 密码'时。
GitHub/GitLab 已禁用纯密码认证，此方式仅适用于部分私有 Git 服务器；
输入后若提示'密码认证失败'，需切换 Token 方式。
核心总结
# SSH 密钥生成
ssh-keygen -t ed25519 -C "你的邮箱" && cat ~/.ssh/id_ed25519.pub
# 保存凭据（Token/密码免重复输入）
git config --global credential.helper [wincred/osxkeychain/store]
# 首次 push（触发认证）
git push -u origin master
# 拉取远程 master 最新代码
git checkout master && git pull origin master
# 创建并切换到 develop 分支（开发主分支）
git checkout -b develop
# 推送 develop 到远程
git push -u origin develop
# 切换到 develop 并拉取最新
git checkout develop && git pull origin develop
# 创建功能分支（命名规范：feature/功能名 - 版本，例：feature/user-login-v1）
git checkout -b feature/xxx-function
# 开发过程中阶段性提交
# 开发中多次本地提交（仅本地，随意提交，不影响远程）
git add .
git commit -m "feat: 实现 xxx 功能核心逻辑"
# 功能开发完成/需要协作/备份时
git push origin feature/xxx-function
# 1. 切换到本地 develop 分支
git checkout develop
# 2. 拉取远程 develop 最新代码（自动合并到本地 develop）
git pull origin develop
# 1. 暂存本地未提交的修改（关键：防止拉取时代码冲突丢失）
git stash
# 2. 切换到 develop 并拉取最新
git checkout develop && git pull origin develop
# 3. 恢复本地暂存的修改（继续开发）
git stash pop
# 4. 若恢复后有冲突，解决后提交
git add . && git commit -m "merge: 解决拉取 develop 后的代码冲突"
# 1. 切换到 develop 并拉取最新
git checkout develop && git pull origin develop
# 2. 切回功能分支，合并 develop 最新代码（同步他人修改）
git checkout feature/xxx-function && git merge develop
# 3. 有冲突则解决后提交，无冲突直接继续开发
git add . && git commit -m "merge: 同步 develop 最新代码到功能分支"
# 1. 拉取功能分支本地最新（防止本地遗漏提交）
git checkout feature/xxx-function && git add . && git commit -m "fix: 修复 xxx 问题"
# 2. 切换到 develop 并拉取远程最新
git checkout develop
git pull origin develop
# 3. 合并功能分支到 develop
git merge feature/xxx-function --no-ff -m "merge: 合并 xxx 功能到 develop"
# 4. 推送合并后的 develop 到远程
git push origin develop
# 5. 删除本地 + 远程功能分支（可选，功能已合并）
git branch -d feature/xxx-function
git push origin -d feature/xxx-function
git fetch origin --prune # 清理远程已删除的分支缓存
# 切换到 develop 并拉取最新
git checkout develop && git pull origin develop
# 创建发布分支（命名规范：release/版本号，例：release/v1.0.0）
git checkout -b release/v1.0.0
# 测试过程中修复小问题（仅改 bug，不新增功能）
git add . && git commit -m "fix: 修复发布前 xxx 小问题"
# 1. 合并到 master（生产分支）
git checkout master && git pull origin master
git merge release/v1.0.0 --no-ff -m "release: 发布 v1.0.0 正式版"
git tag -a v1.0.0 -m "v1.0.0 正式发布" # 打版本标签
git push origin master && git push origin v1.0.0 # 推送 master+ 标签
# 2. 合并到 develop（同步发布分支的修复）
git checkout develop && git pull origin develop
git merge release/v1.0.0 --no-ff -m "merge: 同步 release/v1.0.0 修复到 develop"
git push origin develop
# 3. 删除发布分支（本地 + 远程）
git branch -d release/v1.0.0
git push origin -d release/v1.0.0
git fetch origin --prune
# 切换到 master 并拉取最新生产代码
git checkout master && git pull origin master
# 创建 hotfix 分支（命名规范：hotfix/问题描述 - 版本，例：hotfix/login-bug-v1.0.1）
git checkout -b hotfix/login-bug-v1.0.1
git add . && git commit -m "fix: 紧急修复生产环境登录失败问题"
# 1. 合并到 master 并打新标签
git checkout master && git pull origin master
git merge hotfix/login-bug-v1.0.1 --no-ff -m "hotfix: 修复登录 bug，发布 v1.0.1"
git tag -a v1.0.1 -m "v1.0.1 紧急修复登录问题"
git push origin master && git push origin v1.0.1
# 2. 合并到 develop（同步修复）
git checkout develop && git pull origin develop
git merge hotfix/login-bug-v1.0.1 --no-ff -m "merge: 同步 hotfix 登录 bug 修复到 develop"
git push origin develop
# 3. 删除 hotfix 分支（本地 + 远程）
git branch -d hotfix/login-bug-v1.0.1
git push origin -d hotfix/login-bug-v1.0.1
git fetch origin --prune
# 查看状态
git status
# 查看所有分支（含远程）
git branch -a
# 强制切换分支（放弃本地未提交修改）
git checkout -f develop
# 拉取远程所有分支最新代码
git fetch origin
# 解决冲突后标记为已解决
git add .
# 撤销最近一次提交（保留代码，仅撤回 commit）
git reset --soft HEAD~1
# 推送到远程时强制覆盖（谨慎使用，仅自己的分支）
git push origin feature/xxx-function -f
feature/xxx、release/vx.x.x、hotfix/xxx-vx.x.x；feat/fix/release/hotfix: 描述（符合 Conventional Commits）；merge --no-ff 合并（保留分支历史），禁止直接推送到 master/develop。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 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