Git 中 .gitkeep 占位文件说明

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 里「算有内容」,从而保留文件夹结构。