版本控制与协作 / 系统课时
创建第一次提交
创建第一次提交
学习目标
完成本课后,你将能够:
- 使用 git commit 创建提交
- 编写清晰的提交说明
- 验证提交后仓库是否干净
核心原理
提交会根据当前暂存区创建新的提交对象,并让当前分支指针移动到该提交。工作区中未暂存的修改不会被包含。提交对象一旦创建,其内容和元数据共同决定哈希;之后修改提交说明或内容,会得到新的提交标识。
提交成功后,暂存区通常与新的 HEAD 一致,但工作区可能仍有未暂存修改。不能仅凭“commit 成功”判断任务全部保存,应继续检查状态。
基础用法
常用方式是 git commit -m "说明"。提交说明应描述变更目的,例如 docs: add installation guide,避免 update、fix 等无法提供上下文的词。需要详细说明时,可以使用多个 -m 参数,第一段作为主题,后续段落描述原因、影响或验证方法。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-first-commit-demo
mkdir git-first-commit-demo
cd git-first-commit-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "# Demo Project\n" > README.md
git add README.md
git commit -m "docs: add project readme"
printf "latest commit: "
git log -1 --format='%h %s'
printf "pending changes: "
git status --porcelain | wc -l | tr -d ' '预期输出
text
[<BRANCH> <COMMIT_ID>] docs: add project readme
1 file changed, 1 insertion(+)
create mode 100644 README.md
latest commit: <COMMIT_ID> docs: add project readme
pending changes: 0Tips
- 提交前检查
git diff --staged,提交后检查git status。 - 主题行尽量简洁,重点写“为什么改”而不是机械重复文件名。
- 不要使用
git commit -a代替理解暂存区,它不会包含未跟踪文件。
常见错误
1. nothing to commit
- 错误表现:暂存区为空,执行提交没有可记录内容。
- 正确处理:先查看状态并将目标修改加入暂存区。
2. 提交了不完整内容
- 错误表现:只暂存部分文件却误以为全部已保存。
- 正确处理:提交前查看暂存差异,提交后确认剩余状态。
本课练习
1. 创建首个提交
- 任务目标:创建首个提交。
- 输入或初始条件:新建仓库和 README。
- 实现要求:配置仓库身份、暂存并提交。
- 验收条件:日志包含一条提交且状态干净。
2. 编写两段说明
- 任务目标:编写两段说明。
- 输入或初始条件:准备一次文档修改。
- 实现要求:使用两个
-m参数提交主题和正文。 - 验收条件:
git show -s --format=%B HEAD显示两段内容。
3. 保留未暂存修改
- 任务目标:保留未暂存修改。
- 输入或初始条件:暂存文件后继续编辑。
- 实现要求:提交暂存版本。
- 验收条件:提交成功,但状态仍显示工作区修改。
按自己的节奏,确认真正理解。