git submodule 删除及更新URL

最新推荐文章于 2025-09-17 14:39:54 发布
转载 最新推荐文章于 2025-09-17 14:39:54 发布 · 1.5w 阅读 · 3

本文介绍如何在Git项目中管理submodule，包括删除submodule的方法及更新submodule URL的过程。通过三个简单步骤，可以轻松实现submodule的维护。

删除一个submodule

1.删除 .gitsubmodule中对应submodule的条目

2.删除 .git/config 中对应submodule的条目

3.执行 git rm --cached {submodule_path}。注意，路径不要加后面的“/”。例如：你的submodule保存在 supports/libs/websocket/ 目录。执行命令为： git rm --cached supports/libs/websocket 

更新submodule的URL

1.更新 .gitsubmodule中对应submodule的条目URL

2.更新 .git/config 中对应submodule的条目的URL

3.执行 git submodule sync

git submodule URL更新方法
IT基础架构
08-08 1576
有时候遇到git submodule的URL不可用需要更新，或者太慢需要更新到最近的mirror URL上。那么应该如何更新呢？然后执行 git submodule sync --recursive 更新所有submodule的URL。先编辑 .gitmodules 文件，修改为你想要的那个URL。...
【git】Git Submodule管理项目子模块
九师兄
10-24 1984
1.概述 参考：https://www.cnblogs.com/nicksheng/p/6201711.html 并且修改。 2. 使用场景 当项目越来越庞大之后，不可避免的要拆分成多个子模块，我们希望各个子模块有独立的版本管理，并且由专门的人去维护，这时候我们就要用到git的submodule功能。 常用命令 git clone <repository> --recursive 递归的方式克隆整个项目 git submodule add <repository> <path.
如何更新Submodule URL
qq_41163331的博客
08-23 1193
最近项目要迁移到别的平台，这样就牵涉到如何迁移仓库的问题： 仓库迁移的步骤如下： 仓库迁移 下载原始仓库 git clone --bare git@xxxx1:repo_name.git 迁移到xxxx2平台 cd repo_name git push --mirror ssh://git@xxxxx2/source/repo_name.git 但是我们的项目还有很多submodule，这该怎...
git移除自己之前添加的submodule
最新发布
Tipriest的博客
09-17 380
如下所示添加了一个submodule，但是又不需要了所以想要移除，git在添加的时候很方便，只要一个命令就可以，但是在移除的时候就很不方便了，所以写一个文章记录一下移除的过程，争取能够做到去污无残留。看起来你遇到了一个 submodule 的残留问题。通过这些步骤，你应该能够清理掉残留的 submodule 信息并重新添加它。命令进行查看，如果有自己需要删除的submodule就删除即可。如果以上步骤仍然无法解决问题，考虑使用。如果仍然出现错误，可以尝试使用。
修改.gitmodules文件中的子模块URL
weixin_43074760的博客
06-29 1596
当更改了.gitmodules文件中的子模块 URL 时，Git 不会自动更新已经克隆的子模块。如果希望使用新的 URL 克隆子模块，则需要手动更新子模块的配置。这个命令将会使用.gitmodules文件中的新 URL 克隆或更新子模块，并递归地更新任何子模块的子模块（如果有的话）。这个命令将会更新本地存储库中的 .git/config 文件以反映.gitmodules文件中的新 URL。
git submodule修改url生效
希哈科技
09-06 834
1.手动修改.gitmodules文件 [submodule "src/Hyena"] path = src/Hyena url = https://gitlab.gnome.org/Archive/hyena.git branch = gtk2 2.命令行立即生效 git submodule sync git submodule update --init
git submodule 更新url 操作步骤
会飞的石头
06-07 5480
工作中遇到submodule要更新url的情况，一顿折腾算是搞定，这里记录下必要的操作步骤以备查询。 第一步，修改.gitmodules 中submodule的url； dier
git中submodule子模块的添加、使用和删除的示例代码
10-14
添加子模块的命令是`git submodule add <url> <path>`。这里，`<url>`是你要添加的子模块的Git仓库URL，`<path>`是你希望在主项目中存放子模块的目录名。当你运行这个命令时，Git会在`.gitmodules`文件中添加子模块...
Git Submodule 全流程使用指南
热门推荐
yuxiatongzhi的专栏
04-24 1万+
Git Submodule 全流程使用指南
Git Submodule使用完整教程(小结)
10-14
Git Submodule提供了解决方案，它可以将公共资源作为一个单独的Git仓库（子模块）添加到主项目中，这样每次更新子模块时，只需要在主项目中更新子模块的引用即可。 **2. 创建和管理Git Submodule** 首先，你需要...
git常用操作及git submodule子模块操作和简单讲解，git源码包下载镜像网站推荐，编译安装git，配置git局域网ssh服务端免密操作
qq_41634188的博客
08-01 1265
讲解源码包编译安装git，git涉服务端操作免密以及git常用操作和git submodule子模块操作和讲解。
git submodule 删掉 submodule，之后，尝试重新添加，报错 “A git directory for ‘‘’‘’‘ is found locally with remote(s)”
shimly123456的博客
08-13 909
手动删除干净之后，再次 git submodule add ，发现能够成功。确定 .git/modules/…/ 相关文件夹被删掉了 （重点）还有子模块之前在 repo 里占据的文件夹，这也是肯定要删除干净的。确定 .gitmodules 里的相关部分删干净了。这是因为i删除的时候没有删干净。
Git 修改.Submodule文件 url 生效
qq_25100723的博客
04-27 4095
1. 修改 .gitmodules 文件中对应模块的url属性; 2. 使用 git submodule sync 命令，将新的URL更新到文件.git/config； 3. 再使用命令初始化子模块：git submodule init 4. 最后使用命令更新子模块：git submodule updategit submodule sync 命令很重要 ...
git submodule 删除及更新URL 转载的
rizon886的博客
11-20 418
删除一个submodule 1.删除 .gitsubmodule中对应submodule的条目 2.删除 .git/config 中对应submodule的条目 3.执行 git rm --cached {submodule_path}。注意，路径不要加后面的“/”。例如：你的submodule保存在 supports/libs/websocket/ 目录。执行命令为： git rm --cached supports/libs/websocket 更新submodule的URL 1.更新 .gi...
5步删除 git submodule
11-18 6482
需要先暂存 .gitmodules 文件, 否则会报错: fatal: please stage your changes to .gitmodules or stash them to proceed。移除对应的submodule信息，只有1个submodule信息也可以删除该文件。移除对应的submodule目录。移除对应的submodule信息。
git submodule子模块操作－如何修改子模块的url，以及更新和删除操作
chengde6896383的专栏
01-14 1万+
如何修改子模块的url？ 更改url，并保存。 执行 如果出现如下错误: Unable to find current revision in submodule path 'cape' 则删除cape目录，重新update即可。 子模块的更新 子模块的维护者提交了更新后，使用子模块的项目必须手动更新才能包含最新的提交。 在项目中，进入到子模块目录下，执行 git pull更新，查看...
Git管理子模块 by submodule: 添加、更新、配置、卸载删除、提交、游离分支
weixin_44821980的博客
08-30 1172
如项目A和项目B都依赖项目C的c1模块， 此时可以引入pom依赖。但是项目A和项目B的成员去修改项目C时会显得步骤有些繁琐。
Git 中submodule的使用，终于有人说明白了
Java0258的博客
09-11 1万+
背景 面对比较复杂的项目，我们有可能会将代码根据功能拆解成不同的子模块。主项目对子模块有依赖关系，却又并不关心子模块的内部开发流程细节。 这种情况下，通常不会把所有源码都放在同一个 Git 仓库中。 有一种比较简单的方式，是在当前工作目录下，将子模块文件夹加入到.gitignore文件内容中，这样主项目就能够无视子项目的存在。这样做有一个弊端就是，使用主项目的人需要有一个先验知识：需要在当前目录下放置一份某版本的子模块代码。 还有另外一种方式可供借鉴，可以使用 Git 的submod...
如何修改git submodule的remote url
05-08
<think>好的，我现在需要帮助用户解决如何在Git中修改子模块的远程URL的问题。首先，我应该回忆一下自己之前学过的Git子模块相关知识。用户提到的引用中有一些关于git submodule的命令，比如添加、删除和更新子模块，但用户现在的问题是关于修改子模块的远程仓库URL的。 首先，我需要确认用户的需求：他们想要更改已经存在的子模块的远程仓库地址。比如，子模块原本指向一个旧的仓库URL，现在需要更新到新的URL。这时候，应该怎么做呢？ 根据我之前的了解，Git子模块的配置信息通常存储在两个地方：一个是主项目的.gitmodules文件，另一个是.git/config文件。当添加子模块时，URL会被记录在.gitmodules中，并且当执行git submodule init时，这个URL会被复制到.git/config中。因此，修改远程URL可能需要同时修改这两个地方，或者至少其中一个，具体取决于用户的需求。 现在，我需要验证这个思路是否正确。比如，用户可能已经添加了子模块，但仓库的URL发生了变化，或者他们想将子模块指向另一个仓库。这时候，直接修改.gitmodules文件中的URL是否足够？或者是否需要执行其他命令来使更改生效？ 根据引用中的信息，比如引用[3]提到执行git submodule deinit会删除.git/config中的相关部分，而引用[4]显示了.gitmodules中的配置示例。可能修改.gitmodules中的URL后，还需要重新初始化子模块，或者更新配置。 正确的步骤可能包括以下几个步骤： 1. 修改.gitmodules文件中对应子模块的URL。 2. 同步这个更改到.git/config文件中，可能需要使用git submodule sync命令。 3. 更新子模块的远程URL配置，可能需要进入子模块目录，使用git remote set-url。 但需要确认具体的步骤是否如此。例如，修改.gitmodules后，是否需要运行git submodule sync来让Git识别新的URL？或者是否需要重新初始化子模块？ 另外，是否有更直接的方法，比如使用git config命令直接修改配置？ 比如，用户可以通过编辑.gitmodules文件中的URL，然后运行git submodule sync命令，这会将新的URL从.gitmodules同步到.git/config。或者，如果用户已经手动修改了.gitmodules，可能需要执行git submodule init来重新初始化，但这可能不会自动更新，除非使用sync命令。 另外，用户可能需要进入子模块目录，检查远程URL是否正确，可能需要在那里使用git remote set-url origin <new-url>，但这可能只是针对子模块本身的配置，而主项目可能需要同步这个更改。 现在，我需要整理这些步骤，确保正确性。例如，正确的步骤应该是： 1. 编辑主项目中的.gitmodules文件，修改对应子模块的URL。 2. 运行git submodule sync命令，将新的URL同步到.git/config。 3. 进入子模块目录，更新远程仓库的URL（如果有必要）。 4. 提交主项目的更改，以记录新的URL。 这样，其他开发者在拉取主项目后，执行git submodule update --init时，会使用新的URL。 不过，可能需要验证这些步骤是否正确。比如，git submodule sync的作用是否就是将.gitmodules中的URL更新到.git/config？根据Git文档，git submodule sync会同步子模块的远程URL配置，即将.gitmodules中的URL更新到.git/config以及子模块的git配置中。因此，执行sync后，子模块的远程URL会被更新。 此外，用户可能需要手动进入子模块目录，检查远程URL是否正确，或者在同步后，是否需要重新拉取子模块的新仓库内容？ 另外，如果用户只是想临时更改URL（仅在自己的本地仓库中），可以修改.git/config中的对应部分，而不需要修改.gitmodules，这样其他协作者不会受到影响。但用户的问题可能更倾向于永久更改，即修改.gitmodules并让其他人也使用新的URL。 所以，总结步骤应该是： 方法一：通过编辑.gitmodules并同步： 1. 打开.gitmodules文件，修改子模块的URL。 2. 运行git submodule sync -- <submodule-path>，将新URL同步到.git/config。 3. 提交.gitmodules的更改到版本控制，以便其他人获取更新。 方法二：使用git config命令直接修改： 1. git config --file .gitmodules submodule.<submodule-path>.url <new-url> 2. 同样运行git submodule sync来同步到.git/config。 3. 提交更改。 此外，可能需要更新子模块本身的工作目录，使用git submodule update --remote --force等命令来获取新URL对应的最新提交。 现在，需要确认这些步骤是否有效，是否有遗漏。例如，修改.gitmodules后，如果没有运行sync，直接进行更新，可能会继续使用旧的URL，因为.git/config中的配置可能未被更新。因此，sync步骤是关键。 此外，如果用户已经修改了.gitmodules并提交，其他协作者在拉取主项目后，是否需要运行git submodule sync来更新他们的本地配置？是的，他们需要运行git submodule sync来获取新的URL，然后运行git submodule update来获取子模块的内容。 因此，正确的步骤应该是： - 修改.gitmodules中的URL。 - 运行git submodule sync来同步到.git/config。 - 提交.gitmodules的更改。 - 其他用户拉取后，也需要运行git submodule sync来更新他们的本地配置。 另外，可能需要检查子模块的当前远程是否正确，可以通过进入子模块目录，运行git remote -v查看，并可能需要使用git remote set-url origin <new-url>来确保子模块内部的远程URL也更新了。不过，这可能不是必须的，因为主项目管理的是子模块的URL，而子模块自身的远程配置可能在同步后被覆盖？ 或者，当主项目通过sync命令更新了子模块的URL后，子模块内部的git配置是否会被自动更新？可能需要验证这一点。 比如，当运行git submodule sync时，它会更新三个地方：.gitmodules，.git/config，以及子模块内的.git/config（如果已初始化）。因此，运行sync后，子模块内的远程URL也会被更新。 因此，步骤可能更简单：修改.gitmodules，然后运行git submodule sync，即可更新所有相关的配置，包括主项目和子模块的配置。 所以，综合这些信息，正确的解决方法应该是： 1. 编辑.gitmodules文件，将子模块的URL改为新的地址。 2. 执行git submodule sync -- <子模块路径>，将修改同步到Git配置。 3. 提交对.gitmodules的更改。 4. 如果需要更新子模块的内容，执行git submodule update --init --remote <子模块路径>。 这样，主项目和其他用户都能正确获取到新的子模块URL。 另外，用户可能需要知道如何找到子模块的路径，或者如何确认修改是否成功。例如，检查.gitmodules文件中的内容，或者运行git config --get-regexp submodule查看配置。 总结起来，回答用户的问题需要分步骤说明如何修改URL，并确保他们理解需要同步和提交更改。同时，可能需要提醒他们更新子模块内容，并通知协作者同步更新。</think>### 如何修改Git子模块的远程URL？ #### 方法一：通过编辑`.gitmodules`文件 1. **修改`.gitmodules`文件中的URL** 打开主项目根目录下的`.gitmodules`文件，找到对应子模块的配置，修改`url`字段为新地址。例如： ```ini [submodule "moduleA"] path = path/to/moduleA url = https://github.com/new-url/moduleA.git # 修改此处 ``` 2. **同步配置到Git本地配置** 运行以下命令，将新URL同步到主项目的`.git/config`中： ```bash git submodule sync -- path/to/moduleA ``` 3. **提交更改到主仓库** ```bash git add .gitmodules git commit -m "更新子模块moduleA的远程URL" git push ``` 4. **更新子模块内容（可选）** 若需拉取新URL对应的代码： ```bash git submodule update --init --remote path/to/moduleA ``` --- #### 方法二：直接通过Git命令修改配置 1. **使用`git config`修改URL** 直接修改`.gitmodules`中的配置（无需手动编辑文件）： ```bash git config --file .gitmodules submodule.path/to/moduleA.url https://github.com/new-url/moduleA.git ``` 2. **同步配置并提交** 后续步骤与方法一相同： ```bash git submodule sync -- path/to/moduleA git add .gitmodules git commit -m "更新子模块URL" ``` --- #### 验证修改是否生效 - **检查本地配置**： ```bash git config --file .gitmodules --get-regexp submodule # 或查看子模块目录的远程地址 cd path/to/moduleA git remote -v ``` --- ### 关键注意事项 1. **协作者需同步更新** 其他用户拉取主项目后，需运行`git submodule sync`更新本地配置，再执行`git submodule update --init`[^1][^3]。 2. **子模块的独立仓库特性** 子模块本质是独立仓库，修改远程URL仅影响主项目对其的引用，不会自动修改子模块内部的历史记录或内容。 ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值