跳至主要内容

创建新文件

您可以在拥有写入权限的任何仓库中直接在 GitHub 上创建新文件。

在 GitHub 上创建文件时,请考虑以下事项

  • 如果您尝试在没有访问权限的仓库中创建新文件,我们会将该项目 fork 到您的个人账户,并在您提交更改后帮助您向原始仓库发送 拉取请求
  • 通过网页界面创建的文件名只能包含字母、数字和连字符 (-)。若需使用其他字符,请 在本地创建并提交文件,然后推送到 GitHub 上的仓库
  • 您的仓库可能已启用推送规则集。推送规则集可能会根据特定限制阻止在仓库中创建新文件。推送规则集适用于整个仓库的 fork 网络。这意味着在根仓库中配置的任何推送规则集也会应用于该仓库的每个 fork。更多信息,请参阅 关于规则集

警告

切勿 git addcommitpush 敏感信息(例如密码或 API 密钥)至远程仓库。如果你已经提交了此类信息,请参阅 从仓库中移除敏感数据

  1. 在 GitHub 上,导航至仓库的主页面。

  2. 在您的仓库中,浏览至您想创建文件的文件夹。

  3. 在文件列表上方,选择 添加文件下拉菜单,然后点击 创建新文件

    或者,您可以点击在左侧的文件树视图中。

    Screenshot of the main page of a repository highlighting both the "Add file" and the "plus sign" icon, described above, with an orange outline.

  4. 在文件名字段中,输入文件的名称和扩展名。若要创建子目录,请输入 / 目录分隔符。

  5. 在文件内容文本框中,输入文件内容。

  6. 要预览新内容,请在文件内容上方点击 预览

    Screenshot of a file in edit mode. Above the text box for editing file contents, a tab, labeled "Preview", outlined in dark orange.

  7. 点击 提交更改...

  8. 在“Commit message”字段中,键入简短且有意义的提交信息,描述您对文件所做的更改。您可以在提交信息中将该提交归因于多个作者。欲了解更多信息,请参阅 创建拥有多位作者的提交

  9. 如果您的 GitHub 账户关联了多个电子邮件地址,请点击电子邮件地址下拉菜单并选择要用作 Git 作者电子邮件地址的邮箱。仅已验证的电子邮件地址会出现在此下拉菜单中。如果您启用了电子邮件地址隐私,则默认的提交作者电子邮件地址将是 “no‑reply”。有关 no‑reply 邮箱的具体形式,请参阅 设置提交电子邮件地址

    Screenshot of a GitHub pull request showing a dropdown menu with options to choose the commit author email address. octocat@github.com is selected.

  10. 在提交信息字段下方,决定是将提交添加到当前分支还是新分支。如果您当前的分支是默认分支,建议为提交创建一个新分支,然后发起拉取请求。欲了解更多信息,请参阅 创建拉取请求

    Screenshot of a GitHub pull request showing a radio button to commit directly to the main branch or to create a new branch. New branch is selected.

  11. 点击 提交更改提议更改

© . This site is unofficial and not affiliated with GitHub, Inc.