河北网站开发公司,专业网站建设好不好,西安百度关键词优化,挖掘企业构思的途径常用命令
命令说明git submodule add url 本地路径添加子模块git submodule update --init --recursive添加子模块后#xff0c;同步子模块内容git clone url --recurse-submodules克隆带有子模块的项目git submodule init初始化子模块git submodule…常用命令
命令说明git submodule add url 本地路径添加子模块git submodule update --init --recursive添加子模块后同步子模块内容git clone url --recurse-submodules克隆带有子模块的项目git submodule init初始化子模块git submodule update更新子模块git submodule sync --recursive子模块地址变更git submodule deinit project删除子模块
背景
浏览开源库的时候经常会看到如下子模块的引用情况。
子模块通常是项目比较复杂需要对项目进行拆分而项目又有引用关系时会使用。通常拆分项目后我只需要关注自己的项目更改不需要关注引用的项目都做了哪些更改。
通常这样拆分后项目就不会在一个 git 仓库中这时用 submodule 来管理代码仓库会清晰方便许多。
基本使用
添加子模块
git submodule add url 本地路径例
git submodule add https://github.com/grassto/example.git example执行完毕后发现仓库目录下多了个 example 目录但是里面没有任何文件此时需要再执行
git submodule update --init --recursive这时会看到仓库有如下变化
可以看到 .gitmodules 中有如下内容
[submodule example]path exampleurl https://github.com/grassto/example.git另外.git/config 中会多出一块有关子模块的信息
[submodule example]active trueurl https://github.com/grassto/example.git同时在 .git/mudules 目录下会多出 .git/mudules/example 目录。
克隆带有子模块的项目
直接 clone 只能拉取主项目的代码需要多执行下 submodule 相关的命令如下两种方式
git clone https://github.com/grassto/example.git --recurse-submodules先克隆再初始化子模块拉取
git clone
git submodule init
git submodule update更新子模块
git submodule update
git submodule update --remote不添加 --remote 参数只更新子模块到该仓库使用的最新版本例
子模块一直在自己开发更新了 1.0, 1.1, 1.2 版本但是这时候我的主仓库只使用了 1.0 版本使用 git submodule update 更新后发现只能更新到 1.0 版本。
添加了 --remote 参数则直接更新到子模块仓库的最新版本。
简单理解就是主仓库使用的就是特定版本的子模块仓库若要更新需要主仓库主动进行更新再提交。
子模块地址变动
git submodule sync --recursive若子模块的 url 发生了改变这时执行 git submodule update 会失败可以使用 sync 来同步。
这个我没用过官网上看到的这里提一下。
删除子模块
git submodule deinit example
git rm example
git commit -m delete submodule example推荐使用上面这种方式当然也可以手动删除
删除本地子模块目录
git rm --cached example
rm -rf example删除 .gitmodules 子模块信息
[submodule example]path examplehttps://github.com/grassto/example.git删除 .git/config 文件中的子模块内容
[submodule example]active truehttps://github.com/grassto/example.git删除 .git 文件夹中的相关子模块文件
rm -rf .git/modules/example总结
使用了 submodule 后若不主动更新项目会一直使用固定版本的 submodule 模块需手动更新(git submodule update --remote)。若是在 go 或者其他有包管理的项目中建议还是使用开发语言工具去做这种类似的第三方包管理会比较方便。
其他
作为一个 go 开发我还是提议使用 go module 来做这种包管理这里提一下我使用 submodule 的原因
现在用到了一个包引用的是本地的使用了 replace 特性在做 gitlab CI 的时候需要同步代码仓库感觉不方便顾使用了 git submodule 将代码作为子模块。这样就可以使用 gitlab 的 GIT_SUBMODULE_STRATEGY: recursive 特性。
如果你也是个 go 开发人员这里不建议这么用因为 go module 是可以引用私有库的我这样用是有历史原因的。
我需要引用的库的 go.mod 如下module 的 name 是 example 而不是 github.com/example
module examplego 1.18require ......使用该模块的时候都是将其拉到本地然后 replace。
module workgo 1.18replace example ./example参考
官方文档 Git-Tools-SubmodulesGit中submodule的使用
