当前位置:

首页 > 编程开发 > git submodule子模块的添加和更新【详解】

git submodule子模块的添加和更新【详解】

git submodule子模块的添加和更新【详解】 先说一个核心判断:子模块添加后本地目录为空,这并非bug,而是Git的既定设计;而更新操作不生效,十有八九是没搞懂git submodule update只负责检出固定commit,而非拉取最新代码。 git submodule add 后为什么

本文目录

    git submodule子模块的添加和更新【详解】

    git submodule子模块的添加和更新【详解】

    先说一个核心判断:子模块添加后本地目录为空,这并非bug,而是Git的既定设计;而更新操作不生效,十有八九是没搞懂git submodule update只负责检出固定commit,而非拉取最新代码。

    git submodule add 后为什么子模块目录里没文件?

    当你执行git submodule add时,Git其实只悄悄做了三件事:修改.gitmodules配置文件、将子模块路径以特殊模式(160000)注册到索引、并在.git/modules/下创建一个元数据目录。关键在于,它完全没有去拉取任何子模块的实际代码。

    • 这是新手最容易卡住的第一步——你以为万事俱备,其实只是给子模块“登记了个户口”。
    • 必须补上git submodule update --init,才会真正执行克隆操作,并将子模块内容检出到工作区。
    • 如果子模块本身还嵌套了其他子模块,记得加上--recursive参数:git submodule update --init --recursive。
    • 万一事后发现子模块的URL填错了(比如fork后忘记更新),需要先执行git submodule sync同步URL,再执行update,否则Git还是会傻乎乎地尝试连接旧的地址。

    git submodule update --init 和 --remote 的区别在哪?

    这两个参数目的截然不同。git submodule update --init是“精确还原师”,它严格依照父仓库中记录的commit hash来恢复子模块状态。而git submodule update --remote则是“主动升级者”,它会进入每个子模块,执行git fetch并合并远程默认分支(通常是origin/main)。

    • --init用于团队协作同步,确保所有协作者检出的子模块版本,与你当初提交父仓库时完全一致。
    • --remote用于主动追踪上游最新进展。但需要警惕的是,这可能会引发合并冲突,并且不会自动将子模块的新commit提交到父仓库,你需要手动git add和commit。
    • 如果想跟踪特定分支,可以使用--remote --branch develop,否则默认跟踪master或main(取决于子模块远程仓库的默认分支设置)。
    • 别混淆了git pull --recurse-submodules:它只更新父仓库中记录的子模块commit ID,并不会进入子模块目录执行git pull,因此子模块的实际代码可能还是旧的。

    克隆含子模块的仓库时怎么一步到位?

    最省心的办法是直接使用git clone --recurse-submodules 。这是Git 2.19及以上版本的标准推荐做法,旧版本可能需要显式添加参数。

    • 如果已经用普通方式git clone完了,才发现子模块目录空空如也,不必重头再来,用git submodule update --init --recursive即可补救。
    • 在CI/CD流水线等自动化场景,建议加上--jobs=4参数并发拉取,提升效率:git submodule update --init --recursive --jobs=4。
    • 注意权限问题:如果子模块使用的是SSH URL(如git@github.com:xxx),而CI环境没有配置对应的SSH密钥,就会卡在Cloning into 'xxx'...并报错Permission denied (publickey)。解决方案是换成HTTPS URL,或者正确配置SSH密钥。

    子模块目录显示 modified,但没改任何文件?

    别紧张,这是正常现象。在父仓库的视角里,子模块目录本质上是一个“gitlink”对象,它只记录一个东西:子模块当前HEAD指向的那个commit hash。所以,一旦你进入子模块目录并改变了它的HEAD(比如切换了分支,或者执行了git pull),父仓库立刻就会将这个子模块路径标记为modified。

    • 这不是错误,而是Git在善意提醒你:“子模块的指针已经偏移了哦”。
    • 如果想让父仓库“承认”这个新状态,你需要回到父仓库目录,执行git add ,然后git commit。
    • 如果只是临时在子模块里调试,不想提交这个变更,可以使用git submodule update --checkout强制将子模块回退到父仓库所记录的commit。
    • 切记,在父仓库使用git checkout -- 对子模块是无效的。

    话说回来,子模块真正的复杂之处,并不在于命令繁多,而在于其核心设计哲学:父仓库只保存子模块在某个时刻的快照指针,而不关心其内部的更新逻辑。因此,每次操作前,都必须想清楚两个根本问题:我这次是要锁定一个稳定版本,还是要主动跟进上游的最新变化?一旦选错策略,后续所有协作者都可能跟着踩坑。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 git
    相关文章 更多
    git解决代码冲突的详细步骤与操作方法
    git解决代码冲突的详细步骤与操作方法

    遇到Git合并冲突别慌张,本文详解冲突产生的原因及标准处理流程,涵盖查看冲突文件、理解标记含义、手动修改代码及完成合并提交的完整步骤,助你高效解决协作开发中的代码冲突问题。

    git创建分支bip的命令及完整操作步骤
    git创建分支bip的命令及完整操作步骤

    想知道如何用Git创建名为bip的分支?本文提供清晰的命令行操作步骤,包括本地创建、切换分支以及推送到远程仓库的方法,适合初学者快速上手。

    GitLab新手创建项目并推送第一次提交的操作指南
    GitLab新手创建项目并推送第一次提交的操作指南

    本文指导GitLab新手完成创建项目并推送第一次提交的最小闭环。涵盖远程项目创建、本地仓库初始化、添加远程地址及执行git push。重点说明HTTPS与SSH认证差异、分支名(master/main)核对及提交验证标准,确保远程仓库真正建立。

    在小说搜搜找不到想看的小说怎么办?小说搜搜换源功能使用详解【必学】
    在小说搜搜找不到想看的小说怎么办?小说搜搜换源功能使用详解【必学】

    小说搜搜搜索不到结果?五种实用解决方法帮你搞定 在小说搜搜里搜不到想看的书?这事儿其实挺常见。问题多半出在书源上——要么是默认的书源还没来得及收录,要么是原先的源数据失效了,更新没跟上。别急,下面这五条解决路径,基本能覆盖绝大多数情况,操作起来也不复杂。 一、通过阅读页调出换源入口手动切换 这个方法

    怎么看B站UP主直播的真实人数?在线观看人数换算教程
    怎么看B站UP主直播的真实人数?在线观看人数换算教程

    “实时人气”不等于真实在线人数,需通过区分标识、验证列表与弹幕、第三方工具比对及互动加权扣除四步估算 当你点开B站的某个直播间,屏幕上那个“实时人气:12.8万”的数字可能让你心头一震,觉得场面火热。然而细看之下,弹幕寥寥无几,互动屈指可数——这场景是不是有点眼熟?问题来了:那个醒目的“人气值”,真

    chrome搜索免验证入口
    chrome搜索免验证入口

    Chrome官方免验证入口为https://www.google.cn/chrome/,提供全平台安装包、免登录即用、本地化安全机制及引擎级性能优化。 到底该去哪里找正版、免费且无需繁琐验证的Chrome浏览器入口?这个问题困扰了不少网友。今天,我们就来直通核心,为大家详细拆解Chrome引擎的官方

    Mac导入Android项目指南
    Mac导入Android项目指南

    网上关于在mac上导入现有项目的android studio操作教程多种多样,以下是我在实际操作中成功导入项目所采用的具体步骤及关键注意事项,供各位开发者参考。 网上的教程确实五花八门,但核心流程其实万变不离其宗。根据多年经验,想要在Mac上把已有的Android项目顺利导入Android Stud

    过程式编程、面向对象编程、函数式编程、泛型编程、元编程
    过程式编程、面向对象编程、函数式编程、泛型编程、元编程

    命令式编程关注执行步骤,声明式描述目标,函数式强调无副作用。回调函数作为参数传递,可导致回调地狱,后由Promise解决。仿函数重载`operator()`,lambda更轻量。元编程生成代码,如模板、装饰器、宏,提升抽象能力。

    如何配置Python项目的.gitignore文件_排除环境相关冗余文件
    如何配置Python项目的.gitignore文件_排除环境相关冗余文件

    Python项目配置.gitignore应排除__pycache__、虚拟环境(venv/.venv等)、IDE生成文件(.idea/.vscode等)及缓存目录。误提交后需用`gitrm--cached`移除索引。建议复用GitHub官方模板并验证规则有效性。

    怎么在VSCode中查看Git冲突记录-图形化合并分支操作实操
    怎么在VSCode中查看Git冲突记录-图形化合并分支操作实操

    VSCode不保存历史冲突记录,仅在合并时实时标记冲突文件。冲突文件位于源代码管理面板的MERGECHANGES分组,带红色感叹号和冲突数量。点击文件以三栏合并编辑器显示当前分支、传入分支和结果区,供用户编辑解决冲突。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。