做开源项目或者团队开发时，代码托管平台更换是常有的事。可能是原平台服务不稳定、收费政策变动，或者单纯想换个更顺手的界面。不管出于什么原因，把本地仓库迁移到新托管平台并不复杂，只要按步骤操作就能平稳过渡，不会丢失任何提交记录。
第一步备份本地仓库
在动任何配置之前，先确保你本地的代码库是完整的。打开终端或命令行，进入你的项目目录，执行git status确认没有未提交的冲突。如果有需要保存的临时文件，先提交到本地分支。这一步是为了防止误操作导致本地文件丢失，虽然Git本身有恢复机制，但养成备份习惯能省去很多麻烦。
第二步查看并清理旧远程地址
在项目根目录运行git remote -v，你会看到origin对应的旧地址。记下这个地址，后续可能需要手动删除。不要急着删，等确认新地址推送成功后再移除。如果项目里有多个远程地址，比如upstream和origin，建议全部列出来核对清楚，避免只改了一个而漏掉其他。
第三步绑定新托管平台地址
登录新的代码托管网站，创建对应的项目仓库，复制HTTPS或SSH格式的克隆地址。回到终端，使用git remote set-url origin 新地址命令替换旧链接。如果想保留旧地址备用，也可以添加一个新名称比如new-origin，用git remote add new-origin 新地址。设置完成后再次运行git remote -v验证是否已更新成功。
第四步推送到新平台
执行git push -u origin main（或master）将主分支推送到新仓库。如果项目包含多个分支，可以加上--all参数一次性推送所有分支，命令为git push --all origin。遇到权限提示时输入新平台的账号密码或配置SSH密钥。推送过程中注意观察控制台输出，确认没有报错且进度条走完。首次推送可能需要几分钟，尤其是历史提交较多的老项目。
第五步验证与清理
推送完成后，去新托管平台网页刷新看看，确认分支、标签和提交记录都完整显示。本地可以拉取一次测试git pull origin main，检查代码是否一致。确认无误后，旧远程地址就可以安全删除了，运行git remote remove origin即可。如果之前保留了双远程配置，记得调整默认跟踪关系，让后续开发直接指向新平台。
常见注意事项
迁移过程中有几个细节容易踩坑。子模块仓库需要单独处理，父仓库的地址改了之后，子模块的URL可能还是旧的，得进子目录重新set-url。持续集成配置如GitHub Actions或GitLab CI的文件通常不随代码自动迁移，需要在新平台重新上传或修改触发规则。团队协作前务必通知成员更新本地远程地址，否则pull和push都会失败。另外，私有项目的访问令牌和SSH密钥也要及时在新平台生成并配置到开发机里。
整个流程走下来大概只需要十几分钟。掌握这套方法后，以后无论换哪家云托管服务商都能快速切换。核心逻辑就是本地不动、只改远程指向、全量推送、验证清理。保持耐心按顺序执行，代码资产绝对安全。
