实战针对本地项目git如何移除旧仓库关联并且添加关联新仓库-优雅草卓伊凡

0 阅读4分钟

实战针对本地项目git如何移除旧仓库关联并且添加关联新仓库-优雅草卓伊凡

根据你的需求,要将项目的远程仓库从旧地址更换到新地址,整个过程主要分为移除旧仓库关联添加新仓库关联两个步骤。你可以参考下面的流程图,快速了解整个操作过程。

我们以原仓库gitee.com/youyacao/si…

🔍 第一步:检查当前远程仓库

在开始操作前,我们首先需要确认当前项目关联的远程仓库信息。

  1. 打开终端(命令行),进入你的本地项目根目录。
  2. 输入以下命令查看当前关联的远程仓库:
git remote -v

正常情况下,终端会显示出当前远程仓库的名称(通常是 origin)和其对应的URL。这个命令能帮你确认当前关联的远程仓库地址,也就是你想移除的 https://gitee.com/youyacao/siyu-api

git remote -v 的结果显示两个地址是完全正常的,不需要做任何处理。这是Git的标准设计。

为什么会出现两个地址?

Git远程仓库配置包含两个方向的地址:

fetch(拉取)URL:用于从远程仓库下载数据(如 git fetch、git pull)

push(推送)URL:用于向远程仓库上传数据(如 git push)

看了没啥问题那么我们继续

🗑️ 第二步:移除旧的远程仓库关联

确认了旧的远程仓库信息后,就可以移除它了。

  1. 在项目根目录下,执行以下命令来移除旧的远程仓库关联(这里假设远程仓库名称为 origin):
git remote remove origin

命令说明git remote remove origin 命令用于从你的本地Git配置中删除名为 origin 的远程仓库地址。执行后,你的本地仓库就不再与旧的远程仓库关联。

注:如果你的旧远程仓库名称不是 origin,请将命令中的 origin 替换成你查看到的实际名称。

  1. 再次执行 git remote -v 命令进行检查。如果命令执行后没有任何输出,说明旧的远程仓库关联已经成功移除。

➕ 第三步:关联新的远程仓库

现在,可以将你的本地项目关联到新的远程仓库了。

  1. 使用以下命令添加新的远程仓库地址(这里同样使用 origin 作为名称):
git remote add origin https://gitee.com/youyacao/xiaoquanzi-api

命令说明git remote add origin <新地址> 命令的作用是添加一个新的远程仓库,并为其命名为 origin。后续的推送(push)和拉取(pull)操作都会指向这个新地址。

  1. 同样,你可以通过 git remote -v 命令来验证新的远程仓库是否已成功添加。此时,终端应该显示新的仓库地址 https://gitee.com/youyacao/xiaoquanzi-api

📤 第四步:推送代码到新仓库

关联好新仓库后,需要将本地的代码和历史记录推送到新的远程仓库。

  1. 执行以下命令,将你本地仓库的所有分支和历史记录推送到新的远程仓库:
git push -u origin --all

命令说明

    • git push 是推送命令。
    • -u 参数(等同于 --set-upstream)会建立本地当前分支与远程对应分支的追踪关系。这样,以后在这个分支上使用简单的 git pushgit pull 就可以自动与远程分支同步,无需再次指定远程仓库和分支。
    • --all 参数表示推送所有本地分支到远程仓库。

完成以上步骤后,你的本地项目就已经成功切换到了新的远程仓库。你可以去Gitee上的新仓库页面刷新查看,确认代码是否已经成功推送。

随便修改了 些东西

成功推送
ok

💡 重要提示与注意事项

在进行上述操作时,有几点需要特别注意:

  • 备份重要数据:在对远程仓库进行任何重大操作(如删除关联)之前,确保你本地的代码是最新且已提交的,或者已经备份了重要的修改。这是一个良好的习惯。
  • 处理分支名称:不同的Git托管平台或新旧仓库的默认分支名可能不同(例如 mastermain)。如果推送时遇到分支相关问题,可以尝试使用 git branch -M main 这样的命令来重命名你的本地主分支,然后再执行推送。
  • 团队协作:如果你的项目是一个团队协作项目,在更换远程仓库地址后,需要通知所有其他开发者,让他们也更新自己本地仓库的远程地址,否则他们可能无法正常推送代码。

如果在操作过程中遇到任何问题,可以随时提问。