版本控制与协作 / 系统课时
删除受 Git 管理的文件
删除受 Git 管理的文件
学习目标
完成本课后,你将能够:
- 正确删除受 Git 管理的文件
- 理解工作区删除与暂存删除的差异
- 提交并验证删除记录
问题背景或应用场景
删除文件不仅是从磁盘移除,还需要让下一次提交记录该路径不再存在。直接使用文件系统删除后,Git 会检测到工作区缺失;使用 git rm 则同时删除工作区文件并把删除加入暂存区。
核心原理
Git 提交保存快照,因此“删除”本质是新快照中不再包含该路径,历史提交仍然能够读取旧内容。直接执行 rm file 后,状态通常显示未暂存删除;再执行 git add file 或 git rm file 才会把删除写入暂存区。
git rm --cached file 只从索引移除路径,保留工作区文件,适合停止跟踪本地配置;普通 git rm 会同时删除磁盘文件。执行前应确认目标路径和是否需要保留本地副本。
基础用法
删除一个确定不再需要的受跟踪文件,可直接使用 git rm <path>,随后检查 git diff --staged --name-status 并提交。批量删除目录时使用递归选项要格外谨慎。若只是误删且尚未暂存,可使用 git restore <path> 从暂存区恢复。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-remove-demo
mkdir git-remove-demo
cd git-remove-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "legacy setting\n" > legacy.conf
git add legacy.conf
git commit -q -m "chore: add legacy configuration"
git rm legacy.conf
git diff --staged --name-status
git commit -q -m "chore: remove legacy configuration"
printf "current file exists: "
test -e legacy.conf && echo yes || echo no
printf "historical content: "
git show HEAD~1:legacy.conf预期输出
text
rm 'legacy.conf'
D legacy.conf
current file exists: no
historical content: legacy settingTips
- 提交删除后旧内容仍在历史中,可用
git show恢复。 - 停止跟踪但保留本地文件时使用
git rm --cached,并立即补充.gitignore。 - 删除目录前先使用状态和路径检查,避免通配符扩大范围。
常见错误
1. 误用 git rm --cached
- 错误表现:希望彻底删除文件,却发现磁盘仍存在。
- 正确处理:
--cached只取消跟踪;需要删除工作区文件时使用普通git rm。
2. 只用 rm 未暂存
- 错误表现:提交后文件仍未从版本历史的新快照中删除。
- 正确处理:使用
git add -u或git rm把删除加入暂存区。
本课练习
1. 记录文件删除
- 任务目标:记录文件删除。
- 输入或初始条件:创建并提交一个临时文件。
- 实现要求:使用
git rm删除并提交。 - 验收条件:当前文件不存在,上一提交仍可读取。
2. 恢复误删文件
- 任务目标:恢复误删文件。
- 输入或初始条件:删除一个已跟踪文件但不要暂存。
- 实现要求:使用恢复命令还原。
- 验收条件:文件内容与 HEAD 一致。
3. 停止跟踪配置
- 任务目标:停止跟踪配置。
- 输入或初始条件:准备一个已提交的本地配置。
- 实现要求:保留本地文件、从索引移除并忽略。
- 验收条件:提交后文件仍在磁盘,状态不再反复提示。
按自己的节奏,确认真正理解。