跳至主要内容

编辑文件

您可以在 GitHub 上直接编辑任何仓库中的文件,使用文件编辑器。

编辑仓库中的文件

提示:如果仓库有任何受保护的分支,您无法使用 GitHub 在受保护的分支中编辑或上传文件。您可以使用 GitHub Desktop 将您的更改移动到新分支并提交它们。有关更多信息,请参阅“关于受保护的分支”和“在 GitHub Desktop 中提交和审查对项目的更改”。

注意:GitHub 的文件编辑器使用 CodeMirror.

  1. 在您的仓库中,浏览到您要编辑的文件。

  2. 在文件视图的右上角,单击 打开文件编辑器。

    Screenshot of a file. In the header, a button, labeled with a pencil icon, is outlined in dark orange.

    注意:您可以选择使用 github.dev 代码编辑器,而不是使用默认文件编辑器编辑和提交文件,方法是选择 下拉菜单并单击github.dev。您也可以通过单击GitHub Desktop克隆仓库并在本地通过 GitHub Desktop 编辑文件。

    Screenshot of a file. In the header, a downwards-facing triangle icon is outlined in dark orange.

  3. 在文本框中,对文件进行任何必要的更改。

  4. 在新的内容上方,单击预览

    Screenshot of a file in edit mode. Above the file's contents, a tab labeled "Preview" is outlined in dark orange.

  5. 单击提交更改...

  6. 在“提交消息”字段中,键入一个简短、有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。有关更多信息,请参阅“创建具有多个作者的提交”。

  7. 如果您在 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.

  8. 在提交信息字段下方,选择将您的提交添加到当前分支还是新分支。如果您的当前分支是默认分支,您应该选择为您的提交创建一个新分支,然后创建一个拉取请求。有关更多信息,请参阅“创建拉取请求”。

    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.

  9. 点击提交更改提出更改

在另一个用户的仓库中编辑文件

当您在另一个用户的仓库中编辑文件时,我们将自动为您分叉仓库打开拉取请求

  1. 在另一个用户的仓库中,浏览到包含您要编辑的文件的文件夹。点击您要编辑的文件的名称。

  2. 在文件内容上方,点击 。此时,GitHub 会为您分叉仓库。

  3. 在文本框中,对文件进行任何必要的更改。

  4. 在新的内容上方,单击预览

    Screenshot of a file in edit mode. Above the file's contents, a tab labeled "Preview" is outlined in dark orange.

  5. 单击提交更改...

  6. 在“提交消息”字段中,键入一个简短、有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。有关更多信息,请参阅“创建具有多个作者的提交”。

  7. 如果您在 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.

  8. 点击提出更改

  9. 为您的拉取请求输入标题和描述。

  10. 点击创建拉取请求