git 更换远程仓库地址三种方法总结

一、前言

由于公司内部 GitLab 服务器的地址发生变更，导致部分项目无法正常提交代码，因此需要更新相关项目的远程仓库地址。此外，在以下场景中也可能需要修改远程仓库地址：例如，当需要将 Git 克隆协议从 SSH 切换为 HTTPS 时，或是在项目迁移至新的代码托管平台时，都需要相应调整远程仓库配置。

二、环境

• windows 10
• git version 2.34.0.windows.1

三、帮助文档

• GitHub文档

四、三种远程仓地址更换方法

方法一：不删除远程仓库修改（最方便，推荐）

# 查看远端地址
git remote -v  
# 查看远端仓库名
git remote 
# 重新设置远程仓库
git remote set-url origin https://gitee.com/xx/xx.git (新地址)

方法二：删除远程仓库修改（谨慎使用）

# 删除远程的仓库
git remote rm origin
# 重新添加远程仓库
git remote add origin  https://gitee.com/xx/xx.git(新地址) 

方法三：修改 .git 文件夹修改（不使用命令）

打开项目目录下隐藏文件夹.git下的config文件内容，将 [remote “origin”] url 修改成你需要替换的新地址：
新地址：

[core]
	repositoryformatversion = 0
	filemode = false
	bare = false
	logallrefupdates = true
	symlinks = false
	ignorecase = true
[submodule]
	active = .
[remote "origin"]
	url = https://gitee.com/xx/xx.git(新地址)  
	fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
	remote = origin
	merge = refs/heads/master

五、迁移SSH登录密钥

按照上面的方法，Git远程已经迁移到新的地址上，此时执行git pull拉取代码。下面说下在使用SSH登录+启用2FA（双因素身份验证）是，如何将把SSH密钥同步过去。

• 找到SSH密钥
  登录旧的git系统，找到：“用户设置\SSH密钥”页面，在“您的 SSH 密钥”下找到最新的密钥文件，打开链接复制文本框中的SSH密钥值。
  或者在本地找到当时使用ssh-keygen命令生成的 .pub 文件，复制文件下的内容。

• 将密钥复制或添加到新的Git仓库
  登录新的git系统，找到：“用户设置\SSH密钥”页面，在“您的 SSH 密钥”创建新的密钥，将上部复制到密钥内容粘贴上去。

• 在没有开启2FA时，到此已经完成了密钥迁移

• 开启2FA是，还需要在 Access tokens 中生成一个token