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

修改已跟踪文件

修改已跟踪文件

学习目标

完成本课后,你将能够:

  • 识别已跟踪文件修改后的状态
  • 查看工作区差异并重新提交
  • 形成修改、检查、暂存、提交的闭环

问题背景或应用场景

项目进入日常开发后,大多数操作不是新增文件,而是修改已经纳入版本控制的文件。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 timeout

Tips

  • 使用路径限制 diff,专注检查当前任务文件。
  • 提交前运行测试或最小验证,确保修改不仅语法正确,也符合预期行为。
  • 大量格式变化与功能修改应拆开提交。

常见错误

1. 直接提交但未重新 add

  • 错误表现:文件暂存后继续修改,最后提交缺少新内容。
  • 正确处理:提交前同时检查未暂存和已暂存差异。

2. 忽略行尾变化

  • 错误表现:一个小修改显示整文件都变化。
  • 正确处理:检查编辑器行尾和编码设置,避免无关格式转换。

本课练习

1. 完成一次配置修改

  • 任务目标:完成一次配置修改。
  • 输入或初始条件:仓库中已有一行配置。
  • 实现要求:修改值、检查差异并提交。
  • 验收条件:日志新增一条提交且状态干净。

2. 保留额外修改

  • 任务目标:保留额外修改。
  • 输入或初始条件:同一文件修改两次,中间暂存一次。
  • 实现要求:比较两种 diff。
  • 验收条件:能够说明每种 diff 展示哪一版。

3. 检查格式噪声

  • 任务目标:检查格式噪声。
  • 输入或初始条件:复制一个多行文本文件。
  • 实现要求:只改变行尾或缩进并观察差异。
  • 验收条件:能够识别非功能性变化。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

修改已跟踪文件

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

登录哪都通