重命名文件

您可以直接在 GitHub 中或使用命令行重命名存储库中的任何文件。

Platform navigation

本文内容

重命名 GitHub

上的文件

你还可以在重命名文件时将文件移动到新位置。

Tip

  • 如果尝试在无权访问的存储库中重命名文件，我们将创建到个人帐户的项目分支，并在你提交更改后帮助你向原始存储库发送拉取请求。
  • 通过 Web 界面创建的文件名只能包含字母数字字符和连字符 (-)。 要使用其他字符，请在本地创建和提交文件，然后将它们推送到仓库。
  • 有些文件（如图像）需要您从命令行重命名它们。 有关详细信息，请参阅使用命令行重命名文件。
  1. 在仓库中浏览到您要重命名的文件。
  2. 在文件视图的右上角，单击 以打开文件编辑器。

文件的屏幕截图。 在标头中，标有铅笔图标的按钮以深橙色标出。

  1. 在文件名字段中，将文件名称更改为所需的新文件名。 您还可以同时更新文件的内容。

    显示存储库文件在 Web 浏览器中打开以供编辑的屏幕截图。 文件名字段处于活动状态，并以深橙色边框突出显示。

  2. 单击“提交更改...”

  3. 在“提交消息”字段中，输入简短、有意义的提交消息，以描述对文件的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息，请参阅“创建有多个作者的提交”。

  4. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。 有关详细信息，请参阅“创建拉取请求”。

    GitHub 拉取请求的屏幕截图，其中显示了一个单选按钮，用于直接提交到主分支或创建新分支。 已选择“新建分支”。

  5. 单击“提交更改”或“建议更改” 。

使用命令行重命名文件

您可以使用命令行重命名仓库中的任何文件。

许多文件可以直接在 GitHub 上重命名，但某些文件（如图像）要求从命令行对它们重命名。

此过程假设您已经：

  1. 打开终端终端Git Bash。

  2. 将当前工作目录更改为您的本地仓库。

  3. 重命名文件，指定旧文件名和要为文件提供的新名称。 这将暂存您的提交更改。

    git mv OLD-FILENAME NEW-FILENAME

  4. 使用 git status 检查旧文件名和新文件名。

    $ git status
> # On branch YOUR-BRANCH
> # Changes to be committed:
> #   (use "git reset HEAD <file>..." to unstage)
> #
> #     renamed: OLD-FILENAME -> NEW-FILENAME
> #

  5. 提交暂存在本地仓库中的文件。

    $ git commit -m "Rename file"
# Commits the tracked changes and prepares them to be pushed to a remote repository.
# 要删除此提交并修改文件，请使用 'git reset --soft HEAD~1' 并再次提交和添加文件。

  6. 将本地存储库中的更改推送到 GitHub.com。

    $ git push origin YOUR_BRANCH
# Pushes the changes in your local repository up to the remote repository you specified as the origin