git rm

文章目录

  • [1. 简介](#1. 简介)
  • [2. 格式](#2. 格式)
  • [3. 选项](#3. 选项)
  • [4. 示例](#4. 示例)
    • [4.1 删除单个文件](#4.1 删除单个文件)
    • [4.2 递归删除目录](#4.2 递归删除目录)
    • [4.3 仅从仓库删除,保留工作区文件](#4.3 仅从仓库删除,保留工作区文件)
    • [4.4 强制删除(忽略本地修改)](#4.4 强制删除(忽略本地修改))
    • [4.5 批量删除特定类型文件](#4.5 批量删除特定类型文件)
    • [4.6 模拟执行(查看将要删除的文件)](#4.6 模拟执行(查看将要删除的文件))
  • [5. 其他](#5. 其他)
    • [5.1 `git rm` vs 普通 `rm` 的区别](#5.1 git rm vs 普通 rm 的区别)
    • [5.2 误删除后如何恢复](#5.2 误删除后如何恢复)
    • [5.3 常用别名设置](#5.3 常用别名设置)
  • [6. 小结](#6. 小结)
  • 参考文献

1. 简介

git rm 命令用于从 Git 仓库和工作区中同时删除文件。它会将删除操作记录下来,等待下一次提交。

与直接使用 rm 命令删除文件不同,git rm 会同时更新暂存区,省去了 git add 的步骤。

注意,git rm 无法删除未受版本控制的文件(untracked file)。

2. 格式

bash 复制代码
git rm [<options>] [--] [<pathspec>...​]

3. 选项

bash 复制代码
-f, --force
  强制删除(即使文件有本地修改)
-r
  递归删除目录及其内容
--cached
  仅从暂存区和版本库中删除,保留工作区文件。可用于文件脱离版本控制
-n, --dry-run
  模拟执行,显示哪些文件会被删除,但不实际删除
--ignore-unmatch
  如果匹配不到文件也不报错
-q, --quiet
  静默模式,不输出删除信息

4. 示例

4.1 删除单个文件

bash 复制代码
# 删除 README.md
git rm README.md

4.2 递归删除目录

bash 复制代码
# 删除 utils 目录及其所有内容
git rm -r utils/

4.3 仅从仓库删除,保留工作区文件

bash 复制代码
# 删除版本库中的 config.env,但保留本地文件(常用于误提交的配置文件)
git rm --cached config.env

4.4 强制删除(忽略本地修改)

bash 复制代码
# 文件有本地修改但仍要删除
git rm -f main.go

4.5 批量删除特定类型文件

bash 复制代码
# 删除所有 .log 文件
git rm *.log

# 递归删除所有 .tmp 文件
# \*.tmp 解释为字面量 *.tmp 传递给 git rm。
# Git 收到参数 *.tmp 后,会自己进行通配符匹配,在索引(暂存区)中查找所有 .tmp 文件并删除。
git rm \*.tmp --cached

4.6 模拟执行(查看将要删除的文件)

bash 复制代码
# 预览哪些文件会被删除
git rm --dry-run *.log

5. 其他

5.1 git rm vs 普通 rm 的区别

操作 工作区 暂存区 是否需要 git add
rm file 删除 仍存在(显示 deleted) ✅ 需要 git add 才能提交删除
git rm file 删除 已删除 ❌ 直接 git commit 即可

5.2 误删除后如何恢复

bash 复制代码
# 误执行 git rm 后,可以从 HEAD 恢复
git reset HEAD file
git checkout -- file

# 或者使用 restore(Git 2.23+)
git restore --source=HEAD file

5.3 常用别名设置

bash 复制代码
git config --global alias.rmc "rm --cached"
git config --global alias.rmr "rm -r"

# 使用别名
git rmc config.env
git rmr old-module/

6. 小结

需求 命令 说明
删除文件(工作区+仓库) git rm file 同时删除,直接提交
递归删除目录 git rm -r dir/ 删除目录及其所有内容
只删仓库,保留工作区 git rm --cached file 适用于误提交的配置文件
强制删除 git rm -f file 忽略本地修改,强制删除
预览删除 git rm --dry-run file 模拟执行,不实际删除

一句话总结 :git rm 是 Git 中的删除命令,它会同时更新工作区和暂存区。需要保留本地文件时用 --cached;误删除后可从 HEAD 恢复。养成删除前用 --dry-run 预览的习惯,避免意外删除。


参考文献

Git - git-rm Documentation

相关推荐
Hvitur2 天前
Git - 多分支合并
git·github
考虑考虑2 天前
git刷新远程分支列表
git·后端·gitlab
AI大模型-小华2 天前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
七分辣度3 天前
GitHub/Git 常用命令及使用场景
git·github
慧都小项4 天前
MyEclipse Inline Diff 实用指南:逐处核对 AI 修改再提交
git·ai编程·myeclipse·java 代码审查·ai 代码修改
德育处主任4 天前
让 Claude Code 在你睡觉时接着干活:tmux、权限策略与验收清单
git·ai编程·命令行
为思念酝酿的痛6 天前
Git基本操作
git·github
wno7048 天前
常用的Git命令清单
大数据·git·elasticsearch
真上帝的左手8 天前
3. 代码管理-Git-进阶
git·源代码管理
YIN_尹8 天前
【git原理与使用】git基本操作及底层原理(二)
大数据·git·elasticsearch