git中子模块问题的问题记录

原创 于 2025-12-23 16:11:10 发布 · 446 阅读 · 6 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测

问题一子模块的错误使用

Git Submodule问题分析：

  1. 什么是Submodule：Git子模块允许在一个Git仓库中嵌入另一个Git仓库
  2. 当前状况：您的charpt7/charpt_ws/src被配置为子模块，但子模块的引用可能未正确初始化或推送
  3. 为什么看不到内容：子模块只是指向另一个仓库的指针，如果子模块仓库不存在或未正确推送，主仓库中就显示为空

解决方案

放弃修复子模块 

转换为普通目录

# 1. 进入项目根目录
cd /path/to/ros2_code_learn

# 2. 备份现有子模块内容（防止数据丢失）
cp -r charpt7/charpt_ws/src charpt7_src_backup

# 3. 移除子模块配置
git submodule deinit -f charpt7/charpt_ws/src

# 4. 清理Git模块缓存
rm -rf .git/modules/charpt7/charpt_ws/src

# 5. 从Git索引中删除子模块
git rm -f charpt7/charpt_ws/src

# 6. 重新添加src目录为普通文件
cp -r charpt7_src_backup/* charpt7/charpt_ws/src/

# 7. 添加到Git并提交
git add charpt7/charpt_ws/src
git commit -m "Fix: Convert submodule to regular directory for charpt7"
git push origin master

# 8. 清理备份
rm -rf charpt7_src_backup

问题二Submodule清理失败

输出

hyl@hyl:~/Programs/Code/ros2_code_learn$ cp -r charpt7/charpt_ws/src charpt7_src_backup
hyl@hyl:~/Programs/Code/ros2_code_learn$ git submodule deinit -f charpt7/charpt_ws/src
hyl@hyl:~/Programs/Code/ros2_code_learn$ rm -rf .git/modules/charpt7/charpt_ws/src
hyl@hyl:~/Programs/Code/ros2_code_learn$ git rm -f charpt7/charpt_ws/src
fatal: 不能查询子模组 'charpt7/charpt_ws/src' 的名称
hyl@hyl:~/Programs/Code/ros2_code_learn$ cp -r charpt7_src_backup/* charpt7/charpt_ws/src/
hyl@hyl:~/Programs/Code/ros2_code_learn$ git add charpt7
hyl@hyl:~/Programs/Code/ros2_code_learn$ git status
位于分支 master
您的分支与上游分支 'origin/master' 一致。

未跟踪的文件:
  （使用 "git add <文件>..." 以包含要提交的内容）
	charpt7_src_backup/
	charpt8/

提交为空，但是存在尚未跟踪的文件（使用 "git add" 建立跟踪）
hyl@hyl:~/Programs/Code/ros2_code_learn$

从您的输出看到：

  • ✅ 备份成功：charpt7_src_backup/
  • ✅ 内容恢复：charpt7/charpt_ws/src/ 现在有实际内容
  • ⚠️ Git状态：有未跟踪文件需要处理
  • ❗ git rm 失败，可能有旧的子模块引用残留

解决方案

手动备份内容

尝试强制清理

# 1. 首先检查当前的Git状态，特别是charpt7的状态
git ls-files charpt7/charpt_ws/src

# 2. 如果上一步显示任何内容，说明还有旧引用，强制删除
git rm --cached -r charpt7/charpt_ws/src 2>/dev/null || true

# 3. 现在重新添加正确的内容
git add charpt7/charpt_ws/src/

# 4. 检查添加的文件是否正确
git status

# 5. 提交修复
git commit -m "Fix: Remove submodule and add regular directory for charpt7 src"

# 6. 推送到远程仓库
git push origin master

问题三嵌入式Git仓库警告

charpt7/charpt_ws/src目录下还有一个.git目录，这就是为什么Git仍然认为它是一个嵌入的git仓库。需要先删除这个内部的git仓库信息。

输出

hyl@hyl:~/Programs/Code/ros2_code_learn$ git ls-files charpt7/charpt_ws/src
charpt7/charpt_ws/src
hyl@hyl:~/Programs/Code/ros2_code_learn$ git rm --cached -r charpt7/charpt_ws/src 2>/dev/null || true
rm 'charpt7/charpt_ws/src'
hyl@hyl:~/Programs/Code/ros2_code_learn$ git add charpt7/charpt_ws/src/
warning: 正在添加嵌入式 git 仓库：charpt7/charpt_ws/src
提示：You've added another git repository inside your current repository.
提示：Clones of the outer repository will not contain the contents of
提示：the embedded repository and will not know how to obtain it.
提示：If you meant to add a submodule, use:
提示：
提示：	git submodule add <url> charpt7/charpt_ws/src
提示：
提示：If you added this path by mistake, you can remove it from the
提示：index with:
提示：
提示：	git rm --cached charpt7/charpt_ws/src
提示：
提示：See "git help submodule" for more information.
hyl@hyl:~/Programs/Code/ros2_code_learn$ git status
位于分支 master
您的分支与上游分支 'origin/master' 一致。

未跟踪的文件:
  （使用 "git add <文件>..." 以包含要提交的内容）
	charpt7_src_backup/
	charpt8/

提交为空，但是存在尚未跟踪的文件（使用 "git add" 建立跟踪）
hyl@hyl:~/Programs/Code/ros2_code_learn$

解决方案

# 1. 首先删除src目录下的.git仓库（这是关键步骤！）
rm -rf charpt7/charpt_ws/src/.git

# 2. 重新添加src目录内容
git add charpt7/char_pt7_ws/src/

# 3. 检查添加状态
git status

# 4. 提交修复
git commit -m "Fix: Remove embedded git repository and add regular directory for charpt7 src"

# 5. 推送到远程
git push origin master

问题四

命令写错了

输出

hyl@hyl:~/Programs/Code/ros2_code_learn$ rm -rf charpt7/charpt_ws/src/.git
hyl@hyl:~/Programs/Code/ros2_code_learn$ git add charpt7/char_pt7_ws/src/
warning: 无法打开目录 'charpt7/char_pt7_ws/src/': 没有那个文件或目录
fatal: 路径规格 'charpt7/char_pt7_ws/src/' 未匹配任何文件
hyl@hyl:~/Programs/Code/ros2_code_learn$ git status
位于分支 master
您的分支与上游分支 'origin/master' 一致。

未跟踪的文件:
  （使用 "git add <文件>..." 以包含要提交的内容）
	charpt7_src_backup/
	charpt8/

提交为空，但是存在尚未跟踪的文件（使用 "git add" 建立跟踪）
hyl@hyl:~/Programs/Code/ros2_code_learn$

解决

# 1. 使用正确的路径添加src目录
git add charpt7/charpt_ws/src/

# 2. 检查添加状态
git status

# 3. 提交修复
git commit -m "Fix: Remove embedded git repository and add regular directory for charpt7 src"

# 4. 推送到远程
git push origin master

问题五Git添加无效

git add没有显示预期效果

输出一

hyl@hyl:~/Programs/Code/ros2_code_learn$ git add charpt7/charpt_ws/src/
hyl@hyl:~/Programs/Code/ros2_code_learn$ git status
位于分支 master
您的分支与上游分支 'origin/master' 一致。

未跟踪的文件:
  （使用 "git add <文件>..." 以包含要提交的内容）
	charpt7_src_backup/
	charpt8/

提交为空，但是存在尚未跟踪的文件（使用 "git add" 建立跟踪）
hyl@hyl:~/Programs/Code/ros2_code_learn$

解决方案

# 1. 检查src目录内容
echo "=== src目录内容 ==="
ls -la charpt7/charpt_ws/src/

# 2. 检查src目录大小
echo "=== src目录大小 ==="
du -sh charpt7/charpt_ws/src/

# 3. 检查Git是否已经在跟踪这些文件
echo "=== Git跟踪状态 ==="
git ls-files charpt7/charpt_ws/src/

# 4. 检查是否有.git目录残留
echo "=== 检查.git目录 ==="
find charpt7/charpt_ws/src -name ".git*" -type f

# 5. 检查备份目录内容对比
echo "=== 备份目录内容 ==="
ls -la charpt7_src_backup/

输出二

hyl@hyl:~/Programs/Code/ros2_code_learn$ ls -la charpt7/charpt_ws/src/
总计 100
drwxrwxr-x 8 hyl hyl  4096 Dec 23 15:29 .
drwxrwxr-x 6 hyl hyl 69632 Nov 27 18:58 ..
drwxrwxr-x 2 hyl hyl  4096 Dec 23 15:12 1.gitkeep
drwxrwxr-x 3 hyl hyl  4096 Nov 24 21:03 autopatrol_interfaces
drwxrwxr-x 7 hyl hyl  4096 Nov 24 21:48 autopatrol_robot
drwxrwxr-x 5 hyl hyl  4096 Nov  2 21:02 fishbot_application
drwxrwxr-x 6 hyl hyl  4096 Oct 31 18:51 fishbot_description
drwxrwxr-x 7 hyl hyl  4096 Nov  2 15:35 fishbot_navigation2
-rw-rw-r-- 1 hyl hyl  1986 Dec 23 15:24 README.md
hyl@hyl:~/Programs/Code/ros2_code_learn$ du -sh charpt7/charpt_ws/src/
556K	charpt7/charpt_ws/src/
hyl@hyl:~/Programs/Code/ros2_code_learn$ git ls-files charpt7/charpt_ws/src/
charpt7/charpt_ws/src
hyl@hyl:~/Programs/Code/ros2_code_learn$ find charpt7/charpt_ws/src -name ".git*" -type f
hyl@hyl:~/Programs/Code/ros2_code_learn$ ls -la charpt7_src_backup/
总计 40
drwxrwxr-x  9 hyl hyl 4096 Dec 23 15:22 .
drwxrwxr-x 12 hyl hyl 4096 Dec 23 15:22 ..
drwxrwxr-x  2 hyl hyl 4096 Dec 23 15:22 1.gitkeep
drwxrwxr-x  3 hyl hyl 4096 Dec 23 15:22 autopatrol_interfaces
drwxrwxr-x  7 hyl hyl 4096 Dec 23 15:22 autopatrol_robot
drwxrwxr-x  5 hyl hyl 4096 Dec 23 15:22 fishbot_application
drwxrwxr-x  6 hyl hyl 4096 Dec 23 15:22 fishbot_description
drwxrwxr-x  7 hyl hyl 4096 Dec 23 15:22 fishbot_navigation2
drwxrwxr-x  8 hyl hyl 4096 Dec 23 15:22 .git
-rw-rw-r--  1 hyl hyl 1986 Dec 23 15:22 README.md
hyl@hyl:~/Programs/Code/ros2_code_learn$

发现问题

  • ✅ src目录有内容（556K，包含多个ROS2包）
  • ✅ 没有.git残留
  • ❌ Git仍把整个src目录当作一个文件跟踪（git ls-files只显示一行）
  • ❌ 需要完全清除旧引用，重新添加内容

解决方案

# 1. 完全移除Git中的错误引用
git rm --cached -r charpt7/charpt_ws/src/

# 2. 清理可能的git modules残留
rm -rf .git/modules/charpt7/charpt_ws/src/ 2>/dev/null || true

# 3. 重新添加src目录的所有内容（不是目录本身）
git add charpt7/charpt_ws/src/*

# 4. 检查添加状态
git status

# 5. 如果上面的命令没有添加README.md，单独添加它
git add charpt7/charpt_ws/src/README.md

# 6. 最终检查
git status

后续结果

从 git status 输出看到：

  • ✅ 删除了错误的submodule引用：删除：charpt7/charpt_ws/src
  • ✅ 添加了所有实际文件：包括完整的ROS2包结构
    • autopatrol_interfaces/ - 自定义接口包
    • autopatrol_robot/ - 巡逻机器人功能包
    • fishbot_application/ - 机器人应用功能包
    • fishbot_description/ - 机器人描述包
    • fishbot_navigation2/ - 导航功能包
  • ✅ 文件数量：60+ 个文件被正确添加

核心解决逻辑

  1. 备份保护：确保数据不丢失
  2. 清理旧引用：移除所有submodule相关的Git引用
  3. 消除仓库身份：删除内部.git目录
  4. 重新添加内容：将文件作为普通文件添加

核心代码

# 1. 备份
cp -r charpt7/charpt_ws/src charpt7_src_backup

# 2. 清理submodule引用
git submodule deinit -f charpt7/charpt_ws/src
rm -rf .git/modules/charpt7/charpt_ws/src
git rm --cached -r charpt7/charpt_ws/src

# 3. 消除内部仓库身份
rm -rf charpt7/charpt_ws/src/.git

# 4. 重新添加内容
git add charpt7/charpt_ws/src/*
git commit -m "Fix: Convert submodule to regular directory"
git push origin master

技术层面

  1. Submodule陷阱：子模块容易造成引用混乱，不适合学习项目
  2. Git身份概念：目录中有.git目录就是独立仓库，会被特殊处理
  3. 批量添加技巧：git add dir/* 添加内容，git add dir/ 添加目录本身

操作层面

  1. 备份优先：任何删除操作前先备份
  2. 诊断驱动：遇到问题先用 ls、git ls-files 等诊断
  3. 分步验证：每步操作后检查状态再进行下一步
标签
#git
Git中子模块更新失败的报错与解决方案
shejizuopin的博客
08-16 2659
在大型项目开发中，Git子模块（Submodule）是管理依赖库的常用工具，但更新过程中常因网络、配置或操作顺序等问题导致失败。本文结合CSDN社区的实战经验，系统梳理子模块更新失败的典型场景、报错分析及解决方案，并提供可落地的操作示例。
Git子模块
weixin_44273311的博客
06-20 1649
介绍了git submodule和git subtree的基本原理和使用
fatal: 引用不是一个树：a27a43...无法在子模组路径 'src/lib/ecl' 中检出 'a27...
spurmoon的博客
08-17 5032
px4下载子模块时出现： fatal: 引用不是一个树：a27a43eafa8f4dd514e89984f5394260a36ea4f6 无法在子模组路径 'src/lib/ecl' 中检出 'a27a43eafa8f4dd514e89984f5394260a36ea4f6' 解决方法为git添加子模块的位置： git add src/lib/ecl 下载子模块命令为： git subm...
git子模块
酌沧
06-08 2998
在 Git 中使用子模块时，Git 会利用几个特殊的文件和配置来管理子模块。
GIT删除子模组
silent56_th的博客
12-07 3481
转载自 http://www.worldhello.net/2010/01/26/425.htmlgit rm --cache submodule_name
github克隆项目中的子模块submodule时遇到“无法访问远程仓库，请检查权限“
zouxu634866的博客
09-04 4376
GitHub真是个开源大宝库，不只能学习代码，还能学习git的使用！ 最近在研究Off-the-Record-iOS项目（https://github.com/chrisballinger/Off-the-Record-iOS）时，学习实践了gitsubmodule的用法！ 这个项目中有一个Submodules文件夹，包含了该项目所引用到的其他GitHub上的开源项目，最开始没注意到，直接Download ZIP拿下来的，发现XCode项目中一堆红色文件名，才发现原来还有很多依赖项目，仔细看了一下还挺不少，
玩转GIT系列之【git submodule update出错提示子模组未对路径注册】
热门推荐
不积跬步，无以至千里！
05-16 2万+
今天在github上找到了一个很有意思的项目，叫做listen1【https://github.com/listen1】，它是一个开源的、用于从各大音乐网站自动化搜索歌曲、避免某个特定的网站因为版权问题而无法听歌的、超级实用的好东东。下面摘自作者的原文： 当我发现找个想听的歌因为版权听不了，需要打开好几个网站开始搜索，来回切换让我抓狂的时候，我知道是时候该做点什么了。 妈妈再也不用担心我找不到我...
Git submodule 子模块的管理和使用
sinat_39750698的博客
07-06 3087
Git submodule 子模块的管理和使用：submodule 子模块的管理和使用1.添加子模块2.查看子模块3.初始化子模块4.更新子模块5.删除子模块6.清理子模块缓存，即删除对应子模块文件夹的索引7. 修改.gitmodules中子模块url，需要同步子模块url8.遍历所有子模块切换分支9.遍历所有子模块拉取最新代码10.“脏的”子模块。子模块.diff文件有的时候出现-dirty的情况，放弃更改.diff文件也没有效果 submodule 子模块的管理和使用 1.添加子模块 git subm
github项目环境一致时无法运行问题
qq_41173427的博客
12-18 274
自身经历做个记录 1.git clone 下来的项目子模块没有下完 解决方案 cd进入项目执行 git submodule update --init --recursive
Git 子模块只更新部分模块的问题排查总结
最新发布
Tipriest的博客
07-17 1131
命令用途关键信息查看子模块状态显示已注册的子模块检查 Git 索引中的子模块160000 模式表示子模块查看本地子模块存储显示实际存在的子模块ls -la检查工作目录确认子模块目录是否存在。
git常见问题记录
李白
10-28 4527
本文介绍了Git使用中的三个常见问题及解决方法。首先讲解了修改远程仓库地址的两种方式：直接修改.git/config文件或使用git remote命令。其次说明了更改.gitmodules后需要执行git submodule sync和update命令使修改生效。最后针对多平台换行符差异问题，提供了三种解决方案：使用dos2unix工具、sed命令删除回车符，或配置Git的自动换行策略，并给出了验证方法。这些技巧能有效解决Git跨平台协作中的常见问题。
Github中子模块的添加和更新
blog
04-23 1213
使用情景 有一个父项目的远程仓库，目前为止没有使用任何子模块，但因新业务的需求，父项目准备使用一个名为 son 的子项目作为子模块，son 这个项目有自己的远程仓库，目前我们本地电脑上只有一个先前没有使用任何子模块的父项目的本地目录。 新添加子模块 在本地的父仓库的目录中插入一个子模块并使用，假设父仓库的目录是 D:/father/ 首先在 D:/father/ 中点击 git bash here，然后把远程库 son 作为子模块添加进来，假设这里 son 只有一个 master 分支： git submo
git问题记录汇总
小白
11-18 203
git问题记录git问题记录简介git教程git 更新项目出现的问题 （一）出现的问题 （二）出现的问题 （三）如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能，丰富你的文章UML 图表FLowchart流程图导出与导入导出导入 git问题记录简介 很久没有更新自己git上的项目了，最近手上的项目一一结束，准备提交到git做个备份，谁知记忆力不给力，碰到很多问题，在此记录
【GIT】修改GIT提交人记录信息
小笼包不是包的博客
04-24 2375
前言： 场景： 公司内部有git账号，以工号命名，个人账号参与开源项目；提交开源项目的时候用户名没切换成个人账户，导致项目都是工号的提交记录，违反了公司规定。 参考： stackoverflow:How to change the author and committer name and e-mail of multiple commits in Git? 51CTO:修改git全部已提交的用...
Git子模块Submodule操作
Suk__的博客
07-27 1497
什么是submodule? 官方的解释: 顾名思义就是一个项目的子项目,相当于项目中的一个文件夹,里面又是一个独立的项目,这个项目专门用来作为父项目的依赖/库使用 submodule的使用 克隆含有子模块的项目 通常我们都是clone公司的项目下来后跑不起来,就是缺少了submodule,然而clone父项目下来后submodule只是一个空的文件夹 此时我们需要运行两个命令: 1.初始化本地配置文件(.gitmodules文件,这个文件记录了父项目中子模块的路径和url信息) ...
Git系列之子模块git submodule
云纳星辰怀自在
04-15 962
Git Submodule 是 Git 提供的一个功能，允许你将一个 Git 仓库作为另一个 Git 仓库的子目录。这能让你将另一个仓库克隆到自己的项目中，同时还保持独立的提交。子模块允许你将一个 Git 仓库作为另一个 Git 仓库的子目录。通过合理使用Git子模块，可以有效地管理项目依赖和组件，同时保持各个部分的独立性和可维护性。这会拉取子模块的更新并检出指定的提交（默认是master/main分支的最新提交）在大型项目中，将不同组件作为子模块管理，每个组件有独立的开发流程。
什么时候GIT远程仓库的提交记录会消失？
qq_42129375的博客
05-19 3019
文章目录什么时候GIT远程仓库的提交记录会消失情景重现解决附上三个链接GITHUB操作这次事故跟前同事GITHUB的学习GITHUB禁止强制推送forkGIT命令新建分支提交强制覆盖本地代码GIT常用命令图（从网上借用的）反思 什么时候GIT远程仓库的提交记录会消失 情景重现 刚入职新公司，做开发业务，新公司使用GIT做版本控制，然后我这边做一个改动，提交到远程资源仓库，分明提交成功了，但是测试人...
Git子模块使用记录
larrydong的博客
09-23 787
本文仅用于记录自己在使用git submodule时遇到的问题。 参考资料 知乎：git submodule的理解 知乎：git中submodule的使用 一些操作 加入一个远程存在的子模块 git submodule add <submodule_url> 此时会新增.gitmodules和submodule名称两个新增内容。 把现有部分代码搞成子模块并加入 首先创建一个空的repo，拉下来，把代码拷到repo下，提交，形成在remote端存在的子模块 再添加 下拉一个带有子
Git 子模块submodule的使用
h4x0r_007的专栏
08-22 1540
文章目录Git submodule一、普通项目增加submodule二、带submodule的项目更新1. 首次拉取2. 后续MainModule更新：3. 修改SubModule代码1. 修改SubModule代码，提交入库2. 回到MainModule库更新、提交入库 参考资料 7.11 Git 工具 - 子模块 Git submodule的坑 Git submodule 子模块的管理和使用 GIT 子模块 Git submodule git submodule用于：一个git仓库中，包含另一个gi
Git:子模块
希望我的博客，能帮上你解决学习中工作中所遇到的问题
07-06 1287
Git:子模块
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值