版本控制与协作 / 系统课时

创建新的开发分支

创建新的开发分支

学习目标

完成本课后,你将能够:

  • 创建新的开发分支
  • 使用稳定清晰的分支命名
  • 验证新分支起点与当前提交一致

问题背景或应用场景

团队通常在独立功能分支中开发,避免未完成修改直接进入稳定主分支。创建分支时需要明确起点和名称;起点错误会把无关提交带入功能分支,名称混乱会降低远程协作和自动化规则的可读性。

核心原理

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: yes

Tips

  • 分支创建前先确认基线分支和最新提交。
  • 名称表达任务目的,不在名称中加入临时随机信息。
  • 一个分支只承担一个主要目标,完成合并后及时删除。

常见错误

1. 从错误起点创建

  • 错误表现:功能分支包含其他实验提交。
  • 正确处理:回到正确基线重新创建,或在未共享时使用变基整理。

2. 只创建未切换

  • 错误表现:执行 git branch 后仍在原分支修改。
  • 正确处理:使用 git switch -c,或创建后显式 git switch。

本课练习

1. 创建功能分支

  • 任务目标:创建功能分支。
  • 输入或初始条件:仓库已有一个基线提交。
  • 实现要求:创建并切换到 feature/profile。
  • 验收条件:当前分支名称正确。

2. 从指定提交创建

  • 任务目标:从指定提交创建。
  • 输入或初始条件:仓库有多个提交。
  • 实现要求:从前一个提交创建实验分支。
  • 验收条件:新分支哈希等于指定起点。

3. 验证命名规则

  • 任务目标:验证命名规则。
  • 输入或初始条件:准备五个候选名称。
  • 实现要求:使用检查命令找出非法名称。
  • 验收条件:能够解释每个非法原因。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建新的开发分支

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通