Skip to main content

重命名文件

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

重命名 GitHub 上的文件

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

提示

  • 如果尝试在无权访问的存储库中重命名文件,我们将创建到个人帐户的项目分支,并在你提交更改后帮助你向原始存储库发送拉取请求
  • 通过 Web 界面创建的文件名只能包含字母数字字符和连字符 (-)。 要使用其他字符,请在本地创建和提交文件,然后将它们推送到仓库。
  • 有些文件(如图像)需要您从命令行重命名它们。 有关详细信息,请参阅“使用命令行重命名文件”。
  1. 在仓库中浏览到您要重命名的文件。
  2. 在文件视图的右上角,单击 以打开文件编辑器。 编辑文件图标
  3. 在文件名字段中,将文件名称更改为所需的新文件名。 您还可以同时更新文件的内容。 编辑文件名 1. 在页面底部,输入一条简短、有意义的提交消息,描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息,请参阅“创建具有多个共同作者的提交”。 更改的提交消息 1. 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支,则应选择为提交创建新分支,然后创建拉取请求。 有关详细信息,请参阅“创建新的拉取请求”。 提交分支选项 1. 单击“提议文件更改”。 提议文件更改按钮

使用命令行重命名文件

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

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

此过程假设您已经:

  1. 打开终端终端Git Bash。 1. 将当前工作目录更改为您的本地仓库。
  2. 重命名文件,指定旧文件名和要为文件提供的新名称。 这将暂存您的提交更改。
    $ git mv old_filename new_filename
  3. 使用 git status 检查旧文件名和新文件名。
    $ git status
    > # On branch your-branch
    > # Changes to be committed:
    > #   (use "git reset HEAD ..." to unstage)
    > #
    > #     renamed: old_filename -> new_filename
    > #
  4. 提交暂存在本地仓库中的文件。
    $ git commit -m "Rename file"
    # Commits the tracked changes and prepares them to be pushed to a remote repository.
    # 要删除此提交并修改文件,请使用 'git reset --soft HEAD~1' 并再次提交和添加文件。
  5. Push the changes in your local repository to GitHub.com.
    $ git push origin YOUR_BRANCH
    # Pushes the changes in your local repository up to the remote repository you specified as the origin