2026-03-15-因服务器网络访问问题从 GitHub 平滑迁移至 Gitee 等国内平台的方法

title: 2026-03-15-因服务器网络访问问题从 GitHub 平滑迁移至 Gitee 等国内平台的方法date: 2026-03-15tags:Git环境配置在日常开发中我们经常需要将代码仓库从 GitHub 迁移到 Gitee以获得更快的访问速度。本文将教你如何优雅地修改远程源并理清origin与upstream的关系。1. 查看当前配置首先在终端Ubuntu/Windows/Mac 通用进入项目目录查看现有的远程仓库gitremote-v你可能会看到类似下面的输出origin指向你自己的仓库GitHub。upstream指向原作者的仓库如果你是 Fork 的项目。2. 修改远程仓库地址核心命令是重置origin。直接将你的主要推送目标origin修改为 Gitee 地址gitremote set-url origin https://gitee.com/你的用户名/你的仓库名称.git3. upstream 和 origin如果你的仓库是从别人那里 Fork 来的除了origin你还会看到一个upstream源。origin你自己的仓库负责推送和拉取。upstream原作者的仓库负责同步更新。如图所示,在 vscode 中初次执行push命令的时候,会要求选择 push to 的仓库:4. 验证与首次推送修改完成后执行一次带参数的推送重新建立本地分支与 Gitee 远程分支的绑定关系# 检查地址是否已变更为 Giteegitremote-v# 推送并关联分支假设分支名为 maingitpush-uorigin main小贴士-u参数只需执行一次。之后直接点击 VS Code 的同步按钮或输入git push即可。5. 常见问题推送被拒绝Rejected如果 Gitee 仓库不是空的例如自带 README直接推送会报错。解决方案强制合并一次远程历史。# 拉取并合并不相关的历史记录gitpull origin main --allow-unrelated-histories# 再次推送gitpush origin main总结跨平台通用逻辑无论是在 WindowsPowerShell、UbuntuTerminal还是 macOSGit 的底层命令完全一致。想换地址用set-url。想断绝关系用remove。想保持同步保留upstream。