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

创建第一次提交

创建第一次提交

学习目标

完成本课后,你将能够:

  • 使用 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: 0

Tips

  • 提交前检查 git diff --staged,提交后检查 git status。
  • 主题行尽量简洁,重点写“为什么改”而不是机械重复文件名。
  • 不要使用 git commit -a 代替理解暂存区,它不会包含未跟踪文件。

常见错误

1. nothing to commit

  • 错误表现:暂存区为空,执行提交没有可记录内容。
  • 正确处理:先查看状态并将目标修改加入暂存区。

2. 提交了不完整内容

  • 错误表现:只暂存部分文件却误以为全部已保存。
  • 正确处理:提交前查看暂存差异,提交后确认剩余状态。

本课练习

1. 创建首个提交

  • 任务目标:创建首个提交。
  • 输入或初始条件:新建仓库和 README。
  • 实现要求:配置仓库身份、暂存并提交。
  • 验收条件:日志包含一条提交且状态干净。

2. 编写两段说明

  • 任务目标:编写两段说明。
  • 输入或初始条件:准备一次文档修改。
  • 实现要求:使用两个 -m 参数提交主题和正文。
  • 验收条件:git show -s --format=%B HEAD 显示两段内容。

3. 保留未暂存修改

  • 任务目标:保留未暂存修改。
  • 输入或初始条件:暂存文件后继续编辑。
  • 实现要求:提交暂存版本。
  • 验收条件:提交成功,但状态仍显示工作区修改。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建第一次提交

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

登录哪都通