GitHub 如何创建文件夹？仓库新建目录教程

GitHub不支持直接创建空文件夹，需通过三种方式间接实现：一、网页端新建文件时输入含斜杠的路径（如src/components/Button.jsx）；二、命令行本地建目录并添加.gitkeep占位文件后推送；三、调用GitHub API批量创建带路径的文件。

如果您在 GitHub 仓库中直接上传文件时希望将其放入特定目录，但该目录尚不存在，则需手动创建文件夹结构。GitHub 网页界面不支持单独创建空文件夹，必须通过新建文件并指定路径来间接生成目录。以下是实现此目标的多种操作方式：

一、通过新建文件并嵌入斜杠路径创建文件夹

GitHub 允许在填写新文件名时输入包含斜杠（/）的完整路径，系统会自动将路径中各级目录创建为文件夹，并将文件置于最末级目录下。

1、进入目标仓库主页，点击 Add file → Create new file 按钮。

2、在文件名输入框中，**不直接输入文件名**，而是输入带层级的路径，例如：src/components/Button.jsx。

3、输入文件内容（不能为空，至少添加一个空格或注释行）。

4、滚动到页面底部，填写提交信息，点击 Commit new file。

5、提交完成后，src 与 src/components 两个文件夹将同时被创建。

二、使用 Git 命令行本地创建并推送目录

通过本地克隆仓库后，可使用标准文件系统命令新建任意层级的空目录，并通过添加空占位文件（如 .gitkeep）使其被 Git 跟踪，最终推送到 GitHub。

1、在终端中执行 git clone <仓库URL>，将仓库下载到本地。

2、进入仓库根目录，运行 mkdir -p docs/api tutorials/python 创建多层嵌套文件夹。

3、在每个需保留的空文件夹内创建占位文件：touch docs/.gitkeep tutorials/python/.gitkeep。

4、执行 git add docs/ tutorials/ 将目录及占位文件加入暂存区。

5、运行 git commit -m "add empty folders with .gitkeep" 并执行 git push 推送变更。

三、通过 GitHub API 批量创建带路径的文件以生成深层目录

当需要一次性建立复杂目录结构（如 5 层以上嵌套）且避免多次网页操作时，可调用 GitHub REST API 的创建文件接口，每条请求均指定完整路径，从而触发对应路径的自动建夹行为。

1、获取个人访问令牌（Personal Access Token），确保具备 repo 权限。

2、构造 POST 请求至 https://api.github.com/repos/{owner}/{repo}/contents/{file_path}。

3、请求体中设置 path 字段为完整路径（如 lib/utils/string-helper.js），message 为提交说明，content 为 Base64 编码的文件内容（至少一个换行符）。

4、使用 curl 或脚本依次发送多个请求，分别对应不同深度的路径，每次请求均会创建其路径中所有不存在的中间目录。

5、确认响应状态码为 201 Created，表示目录结构已成功写入仓库。