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

删除受 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 setting

Tips

  • 提交删除后旧内容仍在历史中,可用 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. 停止跟踪配置

  • 任务目标:停止跟踪配置。
  • 输入或初始条件:准备一个已提交的本地配置。
  • 实现要求:保留本地文件、从索引移除并忽略。
  • 验收条件:提交后文件仍在磁盘,状态不再反复提示。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

删除受 Git 管理的文件

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

登录哪都通