git 不支持提交空文件夹，因其只跟踪文件内容而不记录空目录；需在空目录中添加 .gitkeep 等占位文件才能被纳入版本控制，这是唯一可靠方案。
Git 为什么不能提交空文件夹
Git 的设计里压根不记录“空目录”这个概念——它只跟踪有内容的 blob 对象（比如文件），而目录只是文件路径的逻辑分组。一旦某个文件夹下没有任何被 Git 跟踪的文件，git status 就直接无视它，git add 也加不进去。
这不是 bug，是 Git 的底层模型决定的。你执行 git add empty_dir/，只要里面没文件，命令就静默失败，连 warning 都不给。
用 .gitkeep 是最简单可靠的占位方案
在空文件夹里放一个叫 .gitkeep 的空文件（名字不强制，但这是约定俗成的），就能让 Git 把整个目录纳入跟踪——因为现在它里面有被跟踪的文件了。
- 在空目录里创建文件：
touch empty_dir/.gitkeep - 确保它被加入暂存区：
git add empty_dir/.gitkeep - 提交后，
empty_dir/就会出现在仓库结构里，且后续即使删掉其他文件，只要.gitkeep还在，目录就不会消失 - 注意：
.gitkeep不是 Git 内置关键字，它只是普通文件名；别写成.gitignore或漏掉点号，否则会被忽略或不起作用
替代方案：.gitignore 里写反向规则？别试
有人想靠 .gitignore 控制空目录，比如在目录里放个 .gitignore 写 !*.txt 之类的，指望“排除所有再反向包含”来触发目录创建——这完全行不通。
-
.gitignore只影响“未被跟踪的文件”，对空目录本身无感 - Git 不会因为
.gitignore存在就自动创建或保留目录 - 更危险的是，如果误配
.gitignore，反而可能把本该跟踪的文件也屏蔽掉 - 结论：绕不开
.gitkeep（或其他占位文件），没有魔法配置能替代
团队协作时要注意 .gitkeep 的可见性和一致性
.gitkeep 文件虽然小，但在多人协作中容易出问题：有人忘了加、有人删了、有人用 .gitkeep.txt 或 README.md 替代，导致目录在某些人本地消失。
- 建议在项目根目录的
README.md里明确写一句：“所有需保留的空目录请包含.gitkeep” - CI/CD 流水线可以加一步检查：
find . -type d -empty -not -path "./.git/*" | grep -q . && echo "空目录未占位" && exit 1 - 不要依赖编辑器自动生成——VS Code、JetBrains 等默认都不创建
.gitkeep，必须手动补
空目录本身没数据，但它的存在往往意味着结构约定（比如 logs/、uploads/），漏掉占位，部署或初始化时就容易报错，而且这种问题通常要等运行时才暴露。
