跳至主要内容

创建新文件

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

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

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

    注意

    推送规则集处于测试阶段,可能会发生变化。

警告:切勿git addcommitpush敏感信息(例如密码或 API 密钥)到远程仓库。如果您已经添加了此信息,请参阅“从仓库中删除敏感数据”。

  1. 在 GitHub.com 上,导航到仓库的主页。

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

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

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

    Screenshot of the main page of a repository. Above the list of files, a button, labeled "Add file," is outlined in dark orange. In the file tree view of the repository, a button with a plus sign icon is also outlined in dark orange.

  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. 在“提交消息”字段中,输入简短且有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。有关更多信息,请参阅“创建具有多个作者的提交”。

  9. 如果您在 GitHub.com 上的帐户中关联了多个电子邮件地址,请点击电子邮件地址下拉菜单并选择要用作 Git 作者电子邮件地址的电子邮件地址。此下拉菜单中仅显示已验证的电子邮件地址。如果您启用了电子邮件地址隐私,则“无回复”将是默认的提交作者电子邮件地址。有关“无回复”电子邮件地址可能采取的确切形式的更多信息,请参阅“设置您的提交电子邮件地址”。

    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. 点击提交更改提出更改