为编程工作坊准备Git仓库：每节课用分支/标签还是独立目录？

核心方案 #

采用「线性提交历史 + 语义化标签 + 自动生成脚本」的组合方案，可同时规避分支/标签方案的历史修改痛点，以及独立目录方案的多副本同步痛点。

具体实现步骤 #

1. 基础仓库架构设计 #

• 仅保留一条主干分支的线性提交历史，每节课的最终代码对应一个独立commit，commit信息统一规范为 feat: 第X节课完成 - 核心知识点：XXX
• 为每节课的对应commit打上轻量标签，命名规则为 lesson-X（如lesson-1、lesson-2），学员可通过git checkout lesson-X一键切换到对应课程的完整代码

2. 历史内容修改流程 #

如果需要调整前序课程的代码，只需操作一次，后续内容自动同步：

1. 执行交互式变基命令定位到待修改的课程commit，将commit前的pick改为edit
2. 调整代码后执行git add . && git commit --amend --no-edit保存修改
3. 执行git rebase --continue完成后续所有commit的自动应用

3. 配套自动化脚本 #

预置两个简单脚本，可一键完成标签更新和独立目录生成，无需手动操作：

标签重打脚本

# 遍历更新所有lesson系列标签
for lesson_num in {1..12}; do
  target_commit=$(git log --grep="^feat: 第${lesson_num}节课完成" --format=%H | head -n 1)
  git tag -f lesson-${lesson_num} ${target_commit}
done
# 强制推送更新后的标签到远程仓库
git push origin --tags -f

独立目录生成脚本

# 一键导出所有课程代码到独立目录
rm -rf ./lesson-packages
mkdir ./lesson-packages
for lesson_num in {1..12}; do
  mkdir ./lesson-packages/lesson-${lesson_num}
  git archive lesson-${lesson_num} | tar -x -C ./lesson-packages/lesson-${lesson_num}
done
# 生成后可直接将目录推送到仓库，或打包为release附件提供下载

方案优势 #

• 维护成本极低：仅需维护一套线性代码历史，前序内容修改仅需操作一次，无需手动同步到多个目录，也无需处理多分支冲突
• 学员体验全覆盖：
  • 跟随课程实操的学员可从初始模板提交开始，逐步迭代代码，每节课结束可和对应标签的代码比对差异
  • 需要直接查看单课完整代码的学员，可直接访问自动生成的独立目录，无需切换分支
• 操作门槛低：脚本预置完成后，所有修改、发布操作仅需3条基础命令即可完成，无需记忆复杂Git规则

内容的提问来源于stack exchange，提问作者Marcel Stör