如何修改 Git 远程仓库的 URL
用 git remote set-url origin 新URL 即可修改远程地址，git remote -v 验证。适用于仓库迁移、HTTPS 与 SSH 互切等场景，本地提交历史与分支不受影响。
一句话回答：git remote set-url origin <新URL>——把名为 origin 的远程地址改成新 URL，改完用 git remote -v 验证。若单独配置了 pushurl，fetch 地址变更不会自动替换它，应另外检查 --push URL。这个操作修改远程 URL 配置，本地提交历史、分支、工作区完全不受影响。仓库迁移服务器、HTTPS 改 SSH 都用它。
三步操作
1. 查看当前远程地址
git remote -v
# origin https://github.com/user/repo.git (fetch)
# origin https://github.com/user/repo.git (push)
2. 设置新 URL
# HTTPS 换成 SSH
git remote set-url origin git@github.com:user/repo.git
# 仓库迁移到新地址
git remote set-url origin https://gitlab.com/team/repo.git
3. 验证
git remote -v
git fetch origin # 实际连通性测试
相关操作速查
| 需求 | 命令 |
|---|---|
| 修改 origin 的 URL | git remote set-url origin 新URL |
| 修改其他远程（如 upstream） | git remote set-url upstream 新URL |
| 单独改 push 的 URL | git remote set-url --push origin 新URL |
| 新增一个远程 | git remote add upstream URL |
| 删除远程 | git remote remove origin |
| 重命名远程 | git remote rename origin old-origin |
HTTPS 与 SSH 互切说明
- HTTPS：
https://github.com/user/repo.git，GitHub Git HTTPS 不接受账号密码，可用 PAT、Git Credential Manager 或 GitHub CLI 授权 - SSH：
git@github.com:user/repo.git，需先在 GitHub 配置 SSH 公钥
切换就是改 URL 的事，但对应的认证方式要就位：切 SSH 前先确认 ssh -T git@github.com 能通。
常见问题（FAQ）
Q：改了 URL 后 push 报 403/认证失败？
A：URL 对了但新地址的权限没配：SSH 场景确认公钥已加到新平台；HTTPS 场景确认 Token 具有对应仓库写权限（fine-grained 与 classic 的权限模型不同），且凭据管理器里没缓存旧账号（Windows 在"凭据管理器"里删掉旧的）。
Q：git remote set-url 报错 "No such remote 'origin'"？
A：这个仓库没有名为 origin 的远程。先 git remote -v 看实际名字，或用 git remote add origin URL 新建。
Q：fork 的项目想同步上游仓库，要改 origin 吗？
A：不要。origin 保持指向你的 fork，额外加一个上游远程：git remote add upstream 原仓库URL，同步时 git fetch upstream 再合并。
核查依据
本文依据官方文档核对，示例未在实际业务环境运行；上线前请按部署版本、权限与数据范围验证。
