GitHub 仓库网页端如何新建文件并提交：文件路径、内容编辑与提交分支核对

临时改一个 README 片段或补一份配置说明，不一定要先把仓库克隆到本地。只要对仓库有写权限，就能在 GitHub 网页端从 Add file 进入编辑器，填好路径和内容，再通过 Commit changes 把文件提交到当前分支或新分支。

这次只完成一个任务：在已有仓库中创建 docs/release-note.md，预览内容，提交到新分支，并在文件页核对路径和提交记录。

先准备一个可验收的小文件

打开自己有写权限的 GitHub 仓库，确认当前位于目标分支和目标目录。示例文件使用 docs/release-note.md，正文只放一段发布说明，便于提交后从文件路径、内容和历史三处核对。

# Release note

本次变更补充网页端提交说明。

不要把密码、访问令牌或个人配置贴进网页编辑器。GitHub 官方文档也提醒，敏感信息一旦提交到远端，后续清理会比一开始不提交麻烦得多。

第 1 步：从仓库文件列表进入新建文件

操作路径：仓库主页 → 文件列表上方 → Add file → Create new file。如果要放进已有目录，先在文件列表中进入那个目录，再打开 Add file；目录位置会成为新文件路径的起点。

进入编辑器后，页面顶部会出现文件名输入框，编辑区下方会出现提交区域。看到文件名框和编辑区域，说明入口已经选对；如果仍在仓库文件列表页，先不要填写内容。

第 2 步：填写路径和文件内容，再看预览

操作路径：文件名输入框 → 输入 docs/release-note.md → 编辑区输入 Markdown → Preview。文件名中的斜杠会创建子目录，文件名尽量使用字母、数字、连字符和常见扩展名，避免网页端不接受的字符。

点击 Preview 后，编辑器会把 Markdown 按渲染结果展示。这里先检查标题、空行和代码标记是否符合预期；预览不对就回到 Edit 修正，不要直接提交。

可见成功状态是：顶部文件路径显示为 .github/workflows/codeql-analysis.yml 一类完整路径，编辑区能切换到 Preview，且 Commit changes... 按钮可用。截图中的示例内容属于官方文档演示，不要把示例文件名或示例正文误抄到自己的仓库。

第 3 步：填写提交信息并选择分支

操作路径：Commit changes... → Commit message → 分支选项 → Commit changes 或 Propose changes。提交说明写成“补充发布说明”这类能说明动作的短句即可。

如果当前是默认分支，协作仓库通常选择新建分支并发起 Pull Request；个人仓库里的低风险小改动，也可以选择直接提交到当前分支。两者的差别不是文件内容，而是提交先落在哪条分支、后续是否要走评审。

可见成功状态是：提交面板明确显示当前分支名称，或出现新分支名称输入框；按钮文字与选择一致。选择新分支时，点击 Propose changes 后通常会进入 Pull Request 创建流程；选择直接提交时，按钮会完成当前分支提交。

第 4 步：回到文件页核对结果

提交完成后回到仓库文件列表，按刚才的目录进入 docs，点击 release-note.md。重点核对三件事：地址栏路径是否准确、页面正文是否是刚才预览的内容、文件页的提交信息是否与本次填写的消息对应。

如果走了新分支，再打开分支选择器确认新分支能看到该文件；如果要合并到默认分支，则从仓库的 Pull Requests 入口继续创建或检查对应请求。不要只看绿色提示就结束，文件路径错一层目录时，后续链接和构建任务仍可能找不到它。

常见问题与处理方式

为什么看不到 Create new file

先确认账号对仓库有写权限，并检查当前是否处于只能读取的分支或受保护分支。没有写权限时，GitHub 可能引导你创建 fork 和 Pull Request，而不是允许直接写入原仓库。

文件名为什么提交不了

网页端创建文件对文件名字符有限制。需要空格、特殊符号或更复杂的路径时，改用本地 Git 创建后推送；不要为了通过网页校验把扩展名删掉。

直接提交和新分支怎么选

个人仓库的单人小修正可以直接提交；多人协作、默认分支受保护或需要代码评审时，选择新分支更稳妥。无论选哪种，最终都要在目标分支的文件页核对。

最后的结果清单

• 仓库文件列表能按预期路径找到 docs/release-note.md。
• 文件页正文与 Preview 结果一致，Markdown 标题和空行没有丢失。
• 提交记录能看到本次提交消息，且分支位置与选择一致。
• 内容中没有密码、令牌、私有地址或不该公开的配置。

做到这四项，网页端新建文件这次操作就完成了。若后续要修改同一个文件，可以在文件页继续进入编辑器，但那已经是另一个“编辑已有文件”的任务。