应执行 git remote set-url origin 更新远程地址，再用 git remote -v 验证；若协议变更需同步配置 ssh 密钥或 https token；子模块地址也须单独更新。
git push 报错 remote origin already exists 怎么办
这是远程仓库地址改了但本地配置没同步的典型表现，git push 会直接失败，而不是提示“地址不对”。本质是本地 origin 还指向旧 URL，Git 拒绝覆盖已存在的 remote 名称。
- 别用
git remote add origin <new-url></new-url>—— 这会报错remote origin already exists - 正确做法是更新已有 remote：运行
git remote set-url origin <new-url></new-url>（把<new-url></new-url>换成你新的仓库地址，比如https://github.com/user/repo.git或git@github.com:user/repo.git） - 执行后用
git remote -v验证是否生效，输出里两个链接（fetch/push）应该都变成新地址
HTTPS 和 SSH 地址混用导致 Permission denied
换地址时容易忽略协议类型差异。比如原来用 HTTPS，新仓库只开了 SSH；或者反过来。错误现象通常是 Permission denied (publickey) 或 fatal: unable to access '...': The requested URL returned error: 403。
- 先确认新仓库支持哪种协议：GitHub/GitLab 页面上点 “Code” 按钮，切换 “SSH” 或 “HTTPS” 标签看地址格式
- 如果要用 SSH，确保本地有对应私钥且已添加到
ssh-agent（ssh-add -l查看） - 如果要用 HTTPS，注意有些平台（如 GitHub）现在强制要求 token 代替密码，需生成 personal access token 并在 URL 中使用：
https://<token>@github.com/user/repo.git</token>
推送时提示 non-fast-forward，需要强制推送吗
地址变更本身不会触发这个错误，但如果远程仓库被其他人重写过历史（比如 git push --force 过），或你本地分支落后于远程，git push 就会拒绝并提示 Updates were rejected because the tip of your current branch is behind。
- 先运行
git pull --rebase origin main（把main换成你当前分支名），拉取最新变更并变基到顶部 - 如果有冲突，解决后
git add . && git rebase --continue - 再
git push—— 大部分情况不需要--force，强行使用可能丢他人提交 - 仅当你明确知道远程历史已被废弃（比如测试仓库误操作），才考虑
git push --force-with-lease（比--force更安全）
子模块 remote 地址也要同步更新
项目含 submodule 时，主仓库换地址只是第一步。子模块自己的 .git/config 里仍存着旧的 url，后续 git submodule update 会失败。
- 进子模块目录：
cd path/to/submodule - 检查当前 remote：
git config --get remote.origin.url - 更新它：
git config remote.origin.url <new-submodule-url></new-submodule-url> - 回到主仓库根目录，提交子模块的 commit hash 变更：
git add path/to/submodule && git commit -m "update submodule url"
