devops-exercises Git 实战:完成你的第一次提交(Commit 01),从仓库初始化到提交验证
devops-exercises Git 实战:完成你的第一次提交(Commit 01),从仓库初始化到提交验证
本篇文章围绕 devops-exercises 开源仓库中 Git Commit 01 练习 展开,讲解如何在本地创建 Git 仓库、暂存并提交一个文件、以及用命令行验证提交是否被成功记录。读完本文,你将掌握 git init、git add、git commit、git log 等核心命令的完整用法,理解提交背后的"工作区—暂存区—Git 目录"三态模型,并能用多种方式独立验证提交结果,为后续的分支、合并、rebase 等进阶练习打好基础。
练习目标:学会在 Git 仓库中提交变更
commit_01.md 是 devops-exercises 仓库 topics/git 目录下的第一个练习,其 Objective 非常明确:
Learn how to commit changes in Git repositories
这个练习不涉及远程仓库、分支或团队协作,而是聚焦于最基础、最高频的本地提交链路。在 DevOps 与 SRE 的日常工作中,无论你管理的是配置清单、Pipeline 定义(如本仓库 topics/cicd 中的 Jenkinsfile)、IaC 代码(如 topics/aws 下的 Terraform main.tf)还是 Shell 脚本,每一次变更都需要以 commit 的形式固化到版本历史中。它是后续所有 Git 操作(分支、合并、rebase、回滚)的基石。
该练习属于仓库 Git 主题索引 中"Commit"分类下的第一个题目,与 Time to Branch、Squashing Commits 共同构成一条从"提交"到"分支"再到"历史整理"的递进学习路径。
五步实操:从空目录到可验证的提交
练习正文给出了 5 步指令,参考解答位于 solutions/commit_01_solution.md。下面按步骤完整展开,并补充每一步的细节与预期输出。
第一步:创建新目录
mkdir my_repo && cd my_repo
这里 my_repo 是练习目录名,你可以按需更换。注意:本仓库(devops-exercises)本身就是一个 Git 仓库,练习要求在新目录中操作,避免在现有仓库中产生无关提交。
第二步:初始化为 Git 仓库
git init
该命令会在当前目录下创建一个隐藏的 .git 目录。根据仓库 Git 主题索引 中"Git Basics"问答的解释,.git 目录存放着项目版本控制所需的全部信息——包括所有提交记录、引用(refs)、对象数据库以及远程仓库地址等;它同时包含一个记录提交历史的日志,使你可以回滚到历史任意状态。
验证初始化结果:
ls -la
# 应看到 .git/ 目录
git status
# 输出类似:On branch master / No commits yet
第三步:创建文件 file 并写入内容
练习要求文件内容为 hello commit,解答中使用的是 hello_commit(下划线版本)。两种写法均可行,本文以练习正文为准:
echo "hello commit" > file
cat file # 输出:hello commit
此时文件存在于**工作目录(working directory)**中,但 Git 尚未跟踪它。
第四步:暂存并提交新文件
git add file
git commit -m "It's my first commit. Exciting!"
这里拆解两条命令各自的职责:
git add file:将file加入暂存区(staging area / index)。根据 Git 主题索引 的说明,暂存区是 Git 目录中的一个简单文件(通常为.git/index),存储着下一次提交将要包含的内容信息;仓库中也有对应的问答直接指出:git add FILES是让 Git 开始跟踪新文件的方式。git commit -m "...":把暂存区中的内容固化为一次提交。参考解答中使用了-a参数(git commit -a -m),它等价于"自动暂存所有已跟踪文件的改动后再提交";由于这里file是全新文件、且已通过git add显式暂存,-a并非必需,但理解其语义有助于后续练习(例如 Squashing Commits 解答中对已跟踪文件的修改只使用git commit -a -m)。
关于暂存区的补充说明:练习的 5 步指令中并未单独列出"暂存"环节,而是直接要求"Commit your new file"。在真实工作流中,git add 与 git commit 通常是分开的——这正是 Git 三态模型的核心价值所在:你可以有选择地把工作目录中的部分修改放入暂存区,再一次性提交,实现"原子化、语义化"的提交粒度。而 git status 恰好用于呈现这三者之间的关系:哪些改动还在工作目录、哪些已进入暂存区、哪些文件尚未被跟踪。
第五步:验证提交已被记录
git log
预期输出类似:
commit <40位十六进制SHA-1哈希> (HEAD -> master)
Author: 你的名字 <你的邮箱>
Date: <提交时间>
It's my first commit. Exciting!
git log 输出的第一行即本次提交的唯一标识符(对象哈希),这说明提交已被写入 .git 对象数据库并挂接到当前分支引用上。至此,练习的 5 步全部完成。
提交验证的多种方式:不止 git log 一种答案
练习在"After you complete the exercise"环节提出两个思考题,其中第二个问题"是否还有其他方式验证提交被创建"正是对验证环节的延伸。结合仓库 Git 主题索引 中关于跟踪状态与 .git 目录的问答,你可以用以下方式交叉验证:
| 验证命令 | 作用 | 判断依据 |
|---|---|---|
git log |
列出提交历史(含哈希、作者、日期、消息) | 出现你的提交即成功 |
git show HEAD |
显示最新提交的详细内容与 diff | 能看到 file 的添加记录 |
git status |
展示工作目录与暂存区状态 | 输出 "nothing to commit, working tree clean" 表示提交已固化 |
git ls-files |
列出被 Git 跟踪的文件 | 出现 file 即表示已被跟踪(该命令对跟踪文件返回退出码 0) |
git rev-parse HEAD |
输出 HEAD 指向的提交哈希 | 有非空哈希输出即表示存在提交 |
git cat-file -p HEAD |
查看 HEAD 提交对象的原始内容 | 能看到 tree 对象哈希与提交信息 |
其中 git ls-files <file> 在 Git 主题索引 中被明确作为判断"文件是否被跟踪"的手段:退出码为 0 表示已被跟踪。git log 对应的历史记录存储于 .git 目录,这也是它能够支撑"回滚到历史版本"的根本原因。
此外,git log --oneline、git log --stat、git log -p 可以分别以单行摘要、变更文件统计、完整补丁三种粒度查看提交,适合作为验证后的进一步探索。
提交背后:Git 的"三态模型"与提交的工作原理
Git 主题索引 中有一道经典问答,直接解释了本练习每一步操作在概念上对应 Git 的哪个区域:
- Git 目录(
.git):Git 存储项目元数据与对象数据库的地方,是 Git 最重要的部分;git clone拷贝的正是它。 - 工作目录:项目某个版本的单一检出(checkout),文件从 Git 目录的压缩数据库中取出并放置到磁盘供你使用或修改。
- 暂存区:Git 目录中一个简单文件(index),记录下一次提交将包含哪些内容,也常被称为索引(index)。
将练习的 5 步映射到该模型:
git init→ 建立 Git 目录;- 创建
file→ 改动发生在工作目录; git add file→ 将工作目录改动登记进暂存区(index);git commit→ 把暂存区内容封装成提交对象写入 Git 目录,并更新当前分支引用;git log→ 读取 Git 目录中的对象数据库,展示提交历史。
值得一提的是,仓库中还解释了 git status 之所以"相当快"的底层原因:提交中的每个文件都存储在 tree 对象中,索引是 tree 对象的扁平化结构,索引中所有文件都带有预计算哈希,diff 操作实际上是在比较哈希值;同时索引缓存了工作目录的信息,当 Git 已缓存某文件信息时就无需再查看磁盘上的工作目录文件。理解这一点,有助于你在后续学习 git diff、git reset 时把握它们的比较对象。
提交的价值:为什么 commit 值得被认真对待
练习的另一个思考题是"What are the benefits of commits?",这是一个开放性问题,结合仓库内容可归纳为以下几个方面:
- 可追溯的历史:
.git目录中包含记录提交历史的日志,可以回滚到任意历史状态。每一次 commit 都是一个可恢复的时间点。 - 变更粒度可控:借助暂存区,你可以把多个改动拆分为多个语义独立的提交,使历史可读、可审查。
- 协作基础:提交是分支、合并、rebase 的最小单元——本仓库后续的 Time to Branch 练习正是"在已有提交的仓库上创建分支并验证提交归属";而 Squashing Commits 练习则演示如何用
git rebase -i将多个小提交合并为一个,以获得更干净的历史。 - 配置/代码即文档:在 DevOps 场景中,Pipeline、IaC、脚本的每一次演进都以 commit 形式沉淀,这正是 devops-exercises 这类仓库以练习驱动学习的价值所在。
仓库 Git 主题索引 中也有反模式提醒:不要"等太久才提交",这是关于提交频率的实践建议。
常见问题与排错
git commit报错 "nothing to commit, working tree clean":说明改动没有进入暂存区。检查是否执行了git add,或文件内容是否真的发生了变化。git commit提示未配置用户名/邮箱:提交前需要git config user.name/git config user.email(或使用--global做全局配置),否则提交会被拒绝。git log显示 "No commits yet":提交未被创建,请复查git status中暂存区的状态。- 想在提交前查看改动内容:使用
git diff(比较工作目录与暂存区)或git diff --cached(比较暂存区与上一次提交),这也是 Git 主题索引 中"How can you see which changes have done before committing them?"的答案。 - 希望提交时自动暂存已跟踪文件的改动:使用
git commit -a -m "...",但请注意它不会自动暂存新创建的未跟踪文件——新文件仍需先git add。
延伸学习路径
完成 Commit 01 后,可以沿着 Git 主题索引 的练习表继续进阶:
- Time to Branch:在一个至少有一次提交的仓库上创建
dev分支、产生新提交,并用git log在master与dev之间对比提交数量,直观理解"分支是指向某条工作线头部的一个指针"(对应解答 branch_01_solution.md); - Squashing Commits:创建两个连续提交后,用
git rebase -i HEAD~2将pick改为squash合并为一条,体会历史整理的收益(对应解答 squashing_commits.md)。
如果希望把练习与真实仓库管理结合,可以在本仓库的 topics/ 目录下自行演练——仓库中大量实践型文件(如 topics/aws 下的 Terraform 配置、topics/cicd 下的 deploy_to_kubernetes)本身就是由一次次有意义的提交累积而成的,这正是 Git 提交价值的直观体现。
小结
通过 Git Commit 01 这一练习,你已经走通了 Git 本地工作流的最小闭环:git init 建立仓库 → 创建文件 → git add 暂存 → git commit 固化 → git log 验证。更重要的是,你理解了每一步背后的三态模型(工作区 / 暂存区 / Git 目录)以及 .git 目录中沉淀的提交历史。这套基础能力将直接支撑你在 devops-exercises 后续练习以及真实 DevOps 工程中,安全、清晰、可追溯地管理每一次代码与配置变更。