版本控制与协作 / 系统课时
创建新的开发分支
创建新的开发分支
学习目标
完成本课后,你将能够:
- 创建新的开发分支
- 使用稳定清晰的分支命名
- 验证新分支起点与当前提交一致
问题背景或应用场景
团队通常在独立功能分支中开发,避免未完成修改直接进入稳定主分支。创建分支时需要明确起点和名称;起点错误会把无关提交带入功能分支,名称混乱会降低远程协作和自动化规则的可读性。
核心原理
git branch <name> 只创建分支,不切换;git switch -c <name> 从当前提交创建并立即切换。也可以在命令末尾指定起点,例如从 main 创建。分支名称实际存储在 refs/heads/ 下,不能包含空格、连续点和某些特殊组合。
命名应稳定表达用途,例如 feature/login、fix/payment-timeout。是否使用斜杠、编号或用户名取决于团队规范,但应避免只有 test、new 等无法说明目的的名称。
基础用法
创建前先同步并切换到正确基线分支,再执行 git switch -c feature/<topic>。使用 git branch --show-current 验证当前分支,使用 git merge-base --is-ancestor <base> HEAD 检查基线是否为祖先。命名合法性可以通过 git check-ref-format --branch <name> 验证。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-create-branch-demo
mkdir git-create-branch-demo
cd git-create-branch-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "base\n" > app.txt
git add app.txt
git commit -q -m "chore: create base"
git switch -q -c feature/login
printf "current branch: "
git branch --show-current
printf "branch name valid: "
git check-ref-format --branch feature/login >/dev/null && echo yes
printf "same starting commit: "
test "$(git rev-parse HEAD)" = "$(git rev-parse HEAD~0)" && echo yes预期输出
text
current branch: feature/login
branch name valid: yes
same starting commit: yesTips
- 分支创建前先确认基线分支和最新提交。
- 名称表达任务目的,不在名称中加入临时随机信息。
- 一个分支只承担一个主要目标,完成合并后及时删除。
常见错误
1. 从错误起点创建
- 错误表现:功能分支包含其他实验提交。
- 正确处理:回到正确基线重新创建,或在未共享时使用变基整理。
2. 只创建未切换
- 错误表现:执行
git branch后仍在原分支修改。 - 正确处理:使用
git switch -c,或创建后显式git switch。
本课练习
1. 创建功能分支
- 任务目标:创建功能分支。
- 输入或初始条件:仓库已有一个基线提交。
- 实现要求:创建并切换到
feature/profile。 - 验收条件:当前分支名称正确。
2. 从指定提交创建
- 任务目标:从指定提交创建。
- 输入或初始条件:仓库有多个提交。
- 实现要求:从前一个提交创建实验分支。
- 验收条件:新分支哈希等于指定起点。
3. 验证命名规则
- 任务目标:验证命名规则。
- 输入或初始条件:准备五个候选名称。
- 实现要求:使用检查命令找出非法名称。
- 验收条件:能够解释每个非法原因。
按自己的节奏,确认真正理解。