重命名 Git 存储库有哪些副作用

Question

假设我需要重命名一个已经被许多开发人员下载的 Git 存储库。

如果我重命名此存储库，会发生什么副作用（如果有的话）？我的意思是除了开发人员必须在本地存储库中执行更改以更改其远程存储库之外

git remote set-url origin new_url

为了便于讨论，请考虑 Git 服务器是私有服务器，并且所有开发人员都属于同一家公司。

值得一提的是，我检查了有关在 Git 中重命名存储库的其他问题，但除了

git remote

更改之外，没有一个问题具体说明了副作用。

重命名 Bitbucket git 存储库如何影响分叉存储库？

如何重命名 Git 存储库？

如何重命名 GitHub 上的存储库？

Answer 1

正如我在四天前的评论中所说，更改名称的唯一真正“副作用”是每个使用名称的人也必须更改其用途。这不完全是副作用，因为它是主要效果：您更改了名称！

更有趣的问题是：谁使用这个名字？这里的一些答案是显而易见的：它存储在各种URL中，通常在各种“远程”下，如

origin

：

$ git config --get remote.origin.url
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/

（这个克隆早于 GitHub 上的公共访问克隆，例如

https://github.com/torvalds/linux

，或者我可能会使用那个）。如果 Linus Torvalds 要在这里重命名他的 Git 存储库，我就必须更改存储的 URL。但你自己已经说过了。

那么：存储库的名称可能存储在哪里？我能想到的唯一其他地方是：

在各种 shell 脚本和 YAML 文件等中，无论出于何种原因，它们都存储在其中；和

• 在
--shared
• 和/或

  --reference

  克隆中，它们在存储库中设置了 Git 所谓的

  alternates

  。
如果您已经制作了此类克隆，则应该检查这一点。如果 Git 有一种更方便的方法来做到这一点可能会很好，但基本上现有的方法是找到所有

.git

目录并检查其中是否有

objects/info/alternates

。另请参阅

git clone --shared 和 --reference 之间有什么区别？

Shell 脚本、YAML 文件等有多种形式，并且没有通用的方法来找到它们，尽管明显的“grep”样式检查是显而易见的。 （它仍然可能会错过任何通过 和/或 压缩转换为二进制的内容。）

Answer 2

远程引用

：如果存储库具有远程引用（例如，origin），则需要更新这些引用以反映新的存储库名称。这包括更新存储库其他克隆中的任何 URL 或引用。

协作者工作流程

：如果有协作者或团队成员使用存储库，他们将需要相应地更新其本地克隆和远程引用。这可确保其本地存储库正确连接到重命名的存储库。

CI/CD 管道

：如果您使用存储库设置了 CI/CD 管道或其他自动化工作流程，则可能需要更新它们以反映新的存储库名称。这包括引用存储库名称或 URL 的任何脚本或配置。

链接和依赖项

：如果存储库被其他系统（例如文档、问题跟踪器或依赖项管理器）链接或引用，则需要更新这些引用以反映新的存储库名称。未能更新这些引用可能会导致链接损坏或依赖关系不正确。

Git 历史记录和引用

：重命名 Git 存储库不会修改现有的提交历史记录或引用。但是，当用户与重命名的存储库交互时，他们需要了解新名称以确保他们使用正确的存储库。

URL 和 Webhooks

：如果存储库与外部服务（例如 Webhooks、问题跟踪器或项目管理工具）集成，则引用存储库的任何 URL 或配置都需要更新以反映新名称。未能更新这些配置可能会导致集成中断或数据不正确。