GitFlow 工作流完整命令手册

方式 2：个人令牌（Token）认证

未配置 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（仅显示一次，务必复制保存）。

方式 3：账号密码认证

未配置 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

2. 初始化 GitFlow 分支结构（基于已有仓库）

# 拉取远程 master 最新代码
git checkout master && git pull origin master
# 创建并切换到 develop 分支（开发主分支）
git checkout -b develop
# 推送 develop 到远程
git push -u origin develop

二、功能开发：feature 分支全流程

1. 从 develop 创建功能分支

# 切换到 develop 并拉取最新
git checkout develop && git pull origin develop
# 创建功能分支（命名规范：feature/功能名 - 版本，例：feature/user-login-v1）
git checkout -b feature/xxx-function

2. 功能开发&本地提交

# 开发过程中阶段性提交
# 开发中多次本地提交（仅本地，随意提交，不影响远程）
git add .
git commit -m "feat: 实现 xxx 功能核心逻辑"
# 功能开发完成/需要协作/备份时
git push origin feature/xxx-function

3. 从 develop 上拉别人的代码

场景 1：本地 develop 分支无未提交修改

# 1. 切换到本地 develop 分支
git checkout develop
# 2. 拉取远程 develop 最新代码（自动合并到本地 develop）
git pull origin develop

场景 2：本地有未提交修改

# 1. 暂存本地未提交的修改（关键：防止拉取时代码冲突丢失）
git stash
# 2. 切换到 develop 并拉取最新
git checkout develop && git pull origin develop
# 3. 恢复本地暂存的修改（继续开发）
git stash pop
# 4. 若恢复后有冲突，解决后提交
git add . && git commit -m "merge: 解决拉取 develop 后的代码冲突"

场景 3：当前在功能分支，需同步 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 最新代码到功能分支"

4. 功能完成：合并到 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 # 清理远程已删除的分支缓存

三、版本发布：release 分支全流程

1. 从 develop 创建发布分支

# 切换到 develop 并拉取最新
git checkout develop && git pull origin develop
# 创建发布分支（命名规范：release/版本号，例：release/v1.0.0）
git checkout -b release/v1.0.0

2. 发布分支测试&修复

# 测试过程中修复小问题（仅改 bug，不新增功能）
git add . && git commit -m "fix: 修复发布前 xxx 小问题"

3. 发布完成：合并到 master+develop

# 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

四、紧急修复：hotfix 分支全流程

1. 从 master 创建紧急修复分支

# 切换到 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

2. 修复 bug 并提交

git add . && git commit -m "fix: 紧急修复生产环境登录失败问题"

3. 修复完成：合并到 master+develop

# 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

核心规范总结

1. 分支命名：feature/xxx、release/vx.x.x、hotfix/xxx-vx.x.x；
2. 提交信息：feat/fix/release/hotfix: 描述（符合 Conventional Commits）；
3. 合并规则：仅通过 merge --no-ff 合并（保留分支历史），禁止直接推送到 master/develop。