如何通过命令行同步修改GitHub远程仓库与本地配置的仓库名称

前提准备 #

原生Git没有操作GitHub远程仓库元数据的能力，要通过命令行完成全量重命名，你需要先安装GitHub官方命令行工具gh：

• Debian/Ubuntu 系统：sudo apt install gh
• macOS 系统：brew install gh
• Windows 系统：winget install GitHub.cli

安装完成后执行登录授权，按照命令行提示完成账号绑定即可：

gh auth login

完整操作步骤 #

注意操作顺序必须先改远程仓库名，再同步本地配置，否则会出现仓库不存在的报错

1. 执行远程仓库重命名，如果当前在本地foo仓库目录下可直接执行：

gh repo rename bar --yes

如果不在仓库目录，指定完整仓库名即可：

gh repo rename <你的GitHub用户名>/foo bar --yes

执行完成后，远程端的仓库名已经从foo变更为bar
2. 重命名本地仓库文件夹：

mv ~/my_github_repos/foo ~/my_github_repos/bar

3. 进入重命名后的本地目录，更新本地Git的远程地址配置：

cd ~/my_github_repos/bar
git remote set-url origin https://github.com/<你的GitHub用户名>/bar.git

4. 验证操作有效性，执行拉取/推送操作确认无报错即可：

git pull origin master

替代方案（不安装gh工具） #

如果不想安装额外工具，先在GitHub网页端完成远程仓库重命名，再执行上述步骤2~4的本地配置更新即可，效果完全一致。

内容的提问来源于stack exchange，提问作者AniketGM