git clean 专门清理未跟踪的文件和目录——编译产物、下载的依赖、临时日志。它和 git reset --hard 是一对:后者覆盖已跟踪文件,前者删除未跟踪文件,合起来能让工作区彻底回到 HEAD 状态。

Git 默认拒绝真的删除,必须显式给 -f;本文把 git clean 的参数逐项列出,并强调「先 -n 再 -f」这条铁律。

ℹ️
关于本系列
本文是《Git 使用教程》按命令拆分的第 15 / 28 篇,全部收录在 Git 栏目。参数表列的是日常高频项,并非穷举;想看某个命令的完整参数,用 git clean -h 看精简列表、git help clean 看完整手册。示例以 Git 2.56.0 为准。

一、命令语法

先看语法骨架,再对照下一节的参数表。<占位> 表示必填值,实际输入时不要带尖括号;[...] 表示可选项,-- 用来分隔选项与路径。

bash语法
git clean [-d] [-f] [-i] [-n] [-q] [-e <pattern>] [-x | -X] [--] [<pathspec>...]

二、参数逐项详解

下表按用途列出 git clean 的常用参数,每项都注明了「它到底改变了什么」。

参数作用
-n / --dry-run只列出会被删的文件,不执行;每次动手前先跑这条
-f / --force真正执行删除;不加它 Git 会拒绝操作(除非配置了 clean.requireForce=false)
-d连未跟踪的目录一起处理;不加只删文件
-x连被 .gitignore 忽略的文件也删(node_modules/、dist/ 等)
-X只删被忽略的文件,保留其它未跟踪文件
-i / --interactive交互式逐项确认,安全系数最高
-e <模式> / --exclude追加一条排除规则,保护不想被删的文件
-q / --quiet只报错误
<pathspec>限定清理范围,如 git clean -fd build/

三种删除范围

命令会删掉
git clean -fd未被忽略的、未跟踪的文件与目录
git clean -fdx上面全部 + 被忽略的构建产物(常用于「干净构建」)
git clean -fdX只删被忽略的文件,新写的未跟踪文件保留

三、常用示例

标准安全流程

bash标准安全流程
git clean -nd                 # 预演:看清会删什么
git clean -ndx                # 连忽略文件一起预演
git clean -fd                 # 确认无误后执行

干净构建

bash干净构建
git clean -ndx
git clean -fdx
git status -sb

保护个别文件 / 交互式

bash保护个别文件 / 交互式
git clean -fd -e "*.local.js"
git clean -i                 # 进入交互菜单逐项选

四、注意事项

⚠️
clean 删掉的文件找不回来
git clean 不经过回收站、不写对象库、也不进 reflog,删了就是删了。尤其 -x 会连 node_modules/、.env 这类忽略文件一起清掉,里面可能有你手工放的东西。任何时候先 -n,再 -f。
和 stash 配合更保险: 拿不准哪些是有用的临时文件时,用 git stash push -u -m "清理前备份" 把它们收进 stash,再放心 git clean -fdx;需要时 git stash pop 就能拿回来。

五、小结

git clean 的全部参数都在回答两个问题:删多广(-d、-x、-X、pathspec)和怎么确认(-n、-i、-e)。把 -n 当前置动作,这条命令就不危险了。

本系列共 28 篇,一个命令一篇,完整目录见 Git 栏目。下一篇:git rm 命令参数详解。