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 命令参数详解。