版本控制与协作 / 系统课时
修改已跟踪文件
修改已跟踪文件
学习目标
完成本课后,你将能够:
- 识别已跟踪文件修改后的状态
- 查看工作区差异并重新提交
- 形成修改、检查、暂存、提交的闭环
问题背景或应用场景
项目进入日常开发后,大多数操作不是新增文件,而是修改已经纳入版本控制的文件。Git 需要明确区分“文件被编辑”“修改已准备提交”和“新版本已创建”三个阶段,才能提供精确差异和安全撤销。
核心原理
已跟踪文件是至少存在于当前索引或历史中的路径。编辑后,工作区内容与暂存区不同,短状态显示右列 M。git diff 按行展示删除和新增内容;暂存后,变化转移到暂存区,需使用 git diff --staged 查看。
Git 的差异是基于行的文本比较结果,不等于程序语义变化。格式化工具可能造成大量无意义差异,因此修改前应明确格式规范,提交前检查是否混入自动换行、文件编码或行尾变化。
基础用法
标准闭环是:先运行 git status,编辑文件,使用 git diff -- <path> 检查,执行 git add <path>,再用 git diff --staged 复查,最后提交并确认状态干净。路径参数可以限制输出范围,避免大型仓库中无关变化干扰判断。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-modify-demo
mkdir git-modify-demo
cd git-modify-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "timeout=10\n" > app.conf
git add app.conf
git commit -q -m "chore: add default timeout"
printf "timeout=30\n" > app.conf
git diff -- app.conf
git add app.conf
git commit -q -m "chore: increase timeout"
git log --oneline --reverse预期输出
text
diff --git a/app.conf b/app.conf
--- a/app.conf
+++ b/app.conf
@@ -1 +1 @@
-timeout=10
+timeout=30
<COMMIT_ID_1> chore: add default timeout
<COMMIT_ID_2> chore: increase timeoutTips
- 使用路径限制 diff,专注检查当前任务文件。
- 提交前运行测试或最小验证,确保修改不仅语法正确,也符合预期行为。
- 大量格式变化与功能修改应拆开提交。
常见错误
1. 直接提交但未重新 add
- 错误表现:文件暂存后继续修改,最后提交缺少新内容。
- 正确处理:提交前同时检查未暂存和已暂存差异。
2. 忽略行尾变化
- 错误表现:一个小修改显示整文件都变化。
- 正确处理:检查编辑器行尾和编码设置,避免无关格式转换。
本课练习
1. 完成一次配置修改
- 任务目标:完成一次配置修改。
- 输入或初始条件:仓库中已有一行配置。
- 实现要求:修改值、检查差异并提交。
- 验收条件:日志新增一条提交且状态干净。
2. 保留额外修改
- 任务目标:保留额外修改。
- 输入或初始条件:同一文件修改两次,中间暂存一次。
- 实现要求:比较两种 diff。
- 验收条件:能够说明每种 diff 展示哪一版。
3. 检查格式噪声
- 任务目标:检查格式噪声。
- 输入或初始条件:复制一个多行文本文件。
- 实现要求:只改变行尾或缩进并观察差异。
- 验收条件:能够识别非功能性变化。
按自己的节奏,确认真正理解。