如何更改远程Git仓库的URI（URL）

技术背景

在使用Git进行项目开发时，有时会遇到需要更改远程仓库URL的情况。例如，服务器域名过期、项目迁移到新的仓库地址，或者从HTTPS协议切换到SSH协议等。因此，掌握更改远程Git仓库URL的方法非常重要。

实现步骤

查看现有远程仓库URL

在更改URL之前，需要先确认当前设置的URL。可以使用以下命令查看：

git remote -v

该命令会显示所有远程仓库的名称及对应的URL，包括fetch和push的地址。

更改远程仓库URL

使用 git remote set-url 命令

可以使用以下命令直接更改 origin 远程仓库的URL：

git remote set-url origin <NEW_GIT_URL_HERE>

其中，<NEW_GIT_URL_HERE> 是新的Git仓库URL。

编辑 .git/config 文件

也可以手动编辑项目根目录下的 .git/config 文件，找到 [remote "origin"] 部分，修改其中的 url 字段为新的URL。示例如下：

[remote "origin"]
fetch = +refs/heads/*:refs/remotes/origin/*
url = ssh://newhost.com/usr/local/gitroot/myproject.git

验证新的远程仓库URL

更改URL后，可以再次使用 git remote -v 命令验证新的URL是否设置成功。

切换协议（HTTPS到SSH）

如果要将远程仓库的URL从HTTPS切换到SSH，可以使用以下命令：

git remote set-url origin [email protected]:USERNAME/REPOSITORY.git

设置上游分支

更改URL后，为了方便后续的 git push 操作，可以设置上游分支：

git branch -u origin/master

核心代码

查看现有远程仓库URL

git remote -v

更改远程仓库URL

git remote set-url origin <NEW_GIT_URL_HERE>

切换协议（HTTPS到SSH）

git remote set-url origin [email protected]:USERNAME/REPOSITORY.git

设置上游分支

git branch -u origin/master

最佳实践

• 在更改URL之前，建议先备份本地仓库，以防意外情况导致数据丢失。
• 如果使用SSH协议，确保本地已经配置好SSH密钥，并且密钥与远程仓库的配置匹配。
• 更改URL后，及时推送和拉取代码，确保本地和远程仓库的数据同步。

常见问题

错误：No such remote ‘[name]’

这个错误表示你尝试更改的远程仓库名称不存在。检查命令中输入的远程仓库名称是否正确。例如：

git remote set-url sofake https://github.com/octocat/Spoon-Knife
fatal: No such remote 'sofake'

确保使用正确的远程仓库名称，通常默认的远程仓库名称是 origin。

git pull 或 git push 失败

如果更改URL后 git pull 或 git push 失败，可能是因为上游分支没有正确设置。可以使用 git branch -u origin/master 命令设置上游分支。另外，也可以分别更新fetch和push的URL：

# 更新fetch URL
git remote set-url origin new.git.url/here
# 更新push URL
git remote set-url --push origin new.git.url/here