讲师中心 微信公众号
AI工具推荐 视频效率加速

git添加空文件夹到仓库的方法【详解】

小辰小哥_9093

小辰小哥_9093

发布时间:2026-05-05 08:31:00

|

717人浏览过

|

来源于php中文网

原创

Git本身不跟踪空文件夹,需通过添加占位文件(如.gitkeep、.gitignore或README.md)使其被识别并提交;推荐使用.gitkeep,因其轻量、无歧义且符合社区惯例。

git添加空文件夹到仓库的方法【详解】

Git 本身不支持直接添加空文件夹——这不是操作失误,而是设计使然。只要目录下没有被 Git 跟踪的文件,git add 就不会把它纳入暂存区,git status 里也完全不会显示它。

为什么 git add folder/ 没反应?

执行 git add path/to/empty_folder 后没有任何输出、也没有出现在 git status 中,是因为 Git 只检查路径下是否有「可跟踪文件」。空目录不产生任何 blob 对象,Git 甚至不认为它“存在”于工作树的版本控制语境中。

常见错误现象:

  • git add 命令静默失败(无报错也无提示)
  • git status 不列出该目录,即使它物理存在
  • git commit -m "add empty dir" 提交后,远程仓库依然看不到该目录

用 .gitkeep 是最稳妥的通用方案

在空目录中放一个空文件,是最轻量、最易理解、团队协作中最少歧义的做法。.gitkeep 不是 Git 内置关键字,只是社区约定俗成的占位文件名——它不触发任何特殊逻辑,但能明确表达意图。

实操建议:

  • 进入目标空目录:cd path/to/empty_folder
  • 创建空文件:touch .gitkeep(Linux/macOS)或 type nul > .gitkeep(Windows cmd),或用 Git Bash 运行 touch .gitkeep
  • 回到仓库根目录,只添加这个文件:git add path/to/empty_folder/.gitkeep(不要用 git add .,避免误提交其他未暂存文件)
  • 提交:git commit -m "chore: keep empty_folder structure"

注意:.gitkeep 文件内容为空即可,无需写注释;也不需要修改 .gitignore——Git 默认不忽略以 . 开头的文件,除非你显式写了 .* 规则。

Github Auto
Github Auto

管PR、盯Issue、跑CI、发Release——GitHub仓库日常运维扔给它。少开几个Chrome标签页。

下载

用 .gitignore 放进空目录反而容易出错

有人尝试在空目录里建 .gitignore 并写入 * + !.gitignore,想靠“忽略全部但保留自己”来骗 Git 跟踪目录。这方法理论上可行,但有明显缺陷:

  • 如果该目录后续要放真实文件,得反复改 .gitignore,维护成本高
  • 某些旧版 Git(! 规则解析不稳定,可能导致文件意外被忽略
  • git status 会显示该 .gitignore 为“untracked”,需额外 git add,不如 .gitkeep 直观

所以除非你明确需要该目录具备「未来自动忽略新文件」的能力,否则不推荐。

批量处理多个空目录时小心递归边界

用 find . -type d -empty -exec touch {}/.gitkeep \; 看似方便,但要注意两点:

  • 它会命中 .git 目录(因为它是空的),导致报错或污染 Git 元数据 —— 加上 -not -path "./.git*" 排除
  • 如果某空目录下有子目录(但子目录也为空),-empty 会匹配所有层级,可能重复创建多个 .gitkeep —— 实际影响不大,但冗余

更安全的写法是:find . -type d -empty -not -path "./.git*" -exec touch {}/.gitkeep \;

真正容易被忽略的是:有些“空目录”其实包含隐藏文件(如 .DS_Store 或 .env),-empty 判定会失败。建议先用 ls -la path/to/dir 确认是否真为空,再批量操作。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

6219

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

1800

2023.07.06

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

1054

2023.07.24

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

4057

2024.04.09

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3801

2024.04.09

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

0

2026.10.16

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

0

2026.10.16

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

0

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn