重命名文件

重命名 GitHub

上的文件

提示

如果你试图在没有访问权限的库中重命名文件，我们会将该项目复制到你的个人账户，并在你提交更改后帮助你向原始库发送拉取请求。
通过 Web 界面创建的文件名只能包含字母数字字符和连字符 (-)。要使用其他字符，请在本地创建和提交文件，然后将它们推送到仓库。
有些文件（如图像）需要您从命令行重命名它们。有关详细信息，请参阅使用命令行重命名文件。

在仓库中浏览到您要重命名的文件。编辑文件按钮

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

       ![显示存储库文件在 Web 浏览器中打开以供编辑的屏幕截图。 文件名字段处于活动状态，并以深橙色边框突出显示。](/assets/images/help/repository/changing-file-name.png)

数据reusables.files.write_commit_message %}数据reusables.files.choose_commit_branch %}数据reusables.files.propose_file_change %}

使用命令行重命名文件

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

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

此过程假设您已经：

在 GitHub 上创建一个仓库，或者有一个你要参与的由其他人所拥有的现有仓库
在计算机上本地克隆存储库

打开终端终端Git Bash。
重命名文件，指定旧文件名和要为文件提供的新名称。这将暂存您的提交更改。
```
git mv OLD-FILENAME NEW-FILENAME
```

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

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

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

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

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

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

Platform navigation

在本文中

重命名 GitHub

使用命令行重命名文件