Git 中 .gitkeep 占位文件说明
- UncleChao
- 笔记
- March 25, 2026
Table Of Contents
Git 中 .gitkeep 占位文件说明
本质
- 不是 Git 官方提供的功能或特殊文件名,只是社区里常用的命名习惯。
- Git 只跟踪文件;空目录不会被记录。克隆或检出后,若没有其它被跟踪文件,该目录可能不会出现。
常见用途
在需要「保留目录结构」但暂时还没有内容时,在目录里放一个几乎为空的小文件(常命名为 .gitkeep),目录里就有了被跟踪的对象,从而整个路径会随仓库一起存在。
例如:06_输出/笔记/、06_输出/项目/ 在只有 .gitkeep 时,仍能把文件夹结构提交上去。
文件名是否必须是 .gitkeep
不必。任何会被 Git 跟踪的文件都可以起到同样作用,例如 README.md、.placeholder 等。.gitkeep 的好处是名字明确表示「仅为占位」,且多数编辑器会正常显示。
与 .gitignore 的关系
若目录下其它文件被忽略规则排除,仍可能相当于「对 Git 而言为空」。此时仍需要至少一个未被忽略的文件(如 .gitkeep 或经规则放行的文件)才能保留该目录。
一句话
.gitkeep = 让空目录在 Git 里「算有内容」,从而保留文件夹结构。