Git远程仓库地址修改不生效？先别急，问题可能出在这几个地方
相信不少开发者都遇到过这个场景：明明执行了 git remote set-url origin https://new.com/repo.git，信心满满地准备推送代码，结果 git push 命令一敲，代码还是飞向了那个旧的地址。这事儿确实让人头疼，但别慌，问题的根源往往比你想象的要简单，也更容易被忽略。
git remote set-url 改不生效？先确认 remote 名字对不对
这可能是最常踩的“坑”。很多人下意识地认为远程仓库默认就叫 origin，但 Git 可没这个强制规定。你的仓库里，远程仓库的名字完全可能是 upstream、github，甚至是某个自定义的名称。
- 第一步，别猜，直接用
git remote -v命令查看。这个命令会清晰列出当前仓库配置的所有远程仓库及其对应的 URL，一目了然。 - 如果输出列表里压根没有
origin，那你对着它操作自然是无效的。正确的做法是：根据实际显示的名字来操作，比如git remote set-url upstream https://...。 - 如果你确实想统一使用
origin这个名字，也有办法：可以先删除旧的远程配置（git remote remove upstream），然后再用新地址添加一个名为origin的远程仓库。
HTTPS 和 SSH 地址混用，导致认证失败或权限拒绝
修改地址时，协议类型是个关键细节，却很容易被忽略。HTTPS 地址依赖账号密码或个人访问令牌（Token）进行认证，而 SSH 地址则完全依靠本地的 id_rsa 私钥和服务器上的公钥配置。如果你把 HTTPS 地址强行换成 SSH 格式（或者反过来），却没有配置好对应的凭证，那么 git push 时就会卡住，并报出 Permission denied (publickey) 或 Authentication failed 这类错误。
- 检查一下：新地址的协议是否匹配你习惯的认证方式？通常，GitHub 推荐使用 HTTPS + 个人访问令牌，而一些企业内部的 GitLab 则可能强制使用 SSH。
- 注意一个细节：如果 HTTPS 地址中包含了用户名（例如
https://user@github.com/...），这可能会导致 Git 忽略你配置在~/.git-credentials或系统凭据管理器里的信息。稳妥的做法是去掉地址中的用户名部分，让凭据管理器自动处理认证。 - 对于 SSH 地址，标准的格式是
git@host:path/repo.git。虽然某些 Git 版本也支持ssh://git@host/path/repo.git这种写法，但兼容性可能不佳，建议使用前者。
子模块（submodule）里的远程地址不会自动同步
这一点尤其需要注意：你修改了主仓库的远程地址，但这并不会自动更新已经初始化好的子模块（submodule）。每个子模块都是一个独立的 Git 仓库，它们自己的 .git/config 文件里，url 字段仍然指向旧的地址。这样一来，后续执行 git submodule update 时，拉取操作就会失败。
- 最直接的方法：进入每个子模块的目录，手动执行一遍
git remote set-url origin https://new.com/sub-repo.git。 - 如果想批量操作，可以在主仓库的根目录执行命令：
git submodule foreach 'git remote set-url origin $(git config --file .gitmodules submodule.$name.url)'。不过，这要求你事先已经更新了.gitmodules文件中的子模块 URL。 - 改完之后，别忘了将更新后的
.gitmodules文件通过git add .gitmodules加入暂存区并提交。否则，其他协作者克隆你的仓库时，子模块的初始 URL 还是旧的。
CI/CD 脚本里硬编码了远程地址，本地改了也没用
在自动化部署大行其道的今天，这个问题越来越常见。很多持续集成/持续部署（CI/CD）流程，比如 GitHub Actions 的 workflow 文件或者 Jenkinsfile，可能会直接写死一个远程仓库地址（例如 git push https://old.com/repo.git），或者通过环境变量拼接 URL。在这种情况下，你在本地修改 git remote 配置，对 CI 系统的行为是完全没有影响的。
- 你需要去检查项目中的所有自动化脚本文件，比如
.yml、.sh、Jenkinsfile等，使用grep搜索git push、git remote add、https://等关键词，找出硬编码的地址。 - 在 CI 脚本中，最佳实践是优先使用 Git 或 CI 平台提供的环境变量，例如 GitHub Actions 中的
${{ github.server_url }}/${{ github.repository }}.git，而不是手动写入具体的域名。 - 如果某些情况下必须写死地址，那么务必确保
.gitmodules文件、CI 配置文件、以及部署文档这三处提到的地址完全一致。漏掉任何一处，都可能成为线上事故的源头。
说到底，修改远程仓库地址这个操作本身并不复杂。真正的难点在于，这个地址信息可能散落在 Git 配置、子模块、CI 脚本、系统凭据管理器，甚至项目文档等多个角落。只改一处而漏掉其他，是这类问题最常见的发生模式，也值得我们投入更多注意力去规避。
