GIT上手实践笔记之3 使用子模块

上个笔记记录了如何上传文件和文件夹。这里我们试验一下如何使用子模块。我们使用别人的代码可以将别人的整个GITHUB上的某一个项目做为一个自己的代码一部分，GIT里面称作子模块submodule。这篇就简单试验一下调用子模块并指定是使用的历史版本。

git clone https://github.com/hexsdr/gittest2
cd gittest2/
git submodule add https://github.com/hexsdr/gittest
cd gittest/
git log
git reset --hard 5c6fdfb7861631fc6d78c308d656b21def24a4f2
cd ../
git add .
git commit -m "add a sumodule which also contain a submodule"
git remote add origin https://github.com/HexSDR/gittest2.git
git push -u origin main

这里要注意我github里面开了两个项目，以前就有一个gittest,我在写这篇blog之前新建一个gittest2项目，咱们这里试验就是要将gittest作为gittest2的一个子模块。

（另外这gittest本身我也在内部引用了另外一个ucu项目，一并看看这种多级引用的效果。这并没有提下在上述的命令里面。）

我们一行一行分析和执行上述代码：

git clone https://github.com/hexsdr/gittest2
cd gittest2/

这里是克隆下来gittest2，之后进入目录，我没有使用 git init，我觉得这样上来就clone 的方便比较简洁和符合逻辑。

git submodule add https://github.com/hexsdr/gittest
cd gittest/

在gittest目录下执行添加子模块的命令，之后进入，之后进入下载下来的子模块目录。

执行上述命令后期间的截图如下：

--------------------------------------------------------------------------------------------------------------------------------

下载下来的同样是gittest的完整仓库，包含了多个版本，我们这里可能只需要选中其之前的某历史版本，那我们就要找到这个版本号，并重置reset到那个版本号。

执行git log，可以看到列出来的历史版本以及当时的commit时候的备注，如下图：

这里列出的提交日志越靠前，也就是越最近的。如果条目比较多，点回车查看下一页。退出列表查看用:q命令，实际就是vim的退出编辑命令。

这里我们看一下找到自己想要的那个版本号，如图，那么我们可以执行 git reset --hard 5c6fdfb7861631fc6d78c308d656b21def24a4f2。 

执行之后现在里面的文件就是当时提交的状态，也就恢复到了过去那个历史时刻的状态。

如果不确定是自己需要找的是哪个版本号，可以在另外开一个目录clone下来，之后用git reset --hard来设置不同版本后查看或编译执行文件来确定。

这个操作完成之后，我们还是退到gittest2目录，就可以进行代码提交了。

cd ../
git add .
git commit -m "add a sumodule which also contain a submodule"
git remote add origin https://github.com/HexSDR/gittest2.git
git push -u origin main

简单的git add . 上传全部代码。

之后git commit ,之后设置 origin关联到gittest2项目地址，之后就push 到main分支。

以上骚作完成之后我们再登录gittest2项目看看。

我们依次点进去子模块就看到下面截图样子。

这种项目中包含其他子模块A，而A又包含B和C，而B有可能包含E,F...子模块无穷匮也，这种方式叫做递归调用（其实不是严格的递归recursive，递归一般说自己调用自己），如果我们要clone下来这个gittest2就要用到关键字：recursivel，如下：

git clone --recursive https://github.com/hexsdr/gittest2

执行截图如下：

 我们可以看到分别clone了gittest2,gittest，ucu项目，并且指定了gittest,ucu的版本号。如果不适用recursive关键词，就会导致只下载下来所包含子模块的空目录。

在github网页上点击引用的子模块会转跳到子模块的原始项目连接，并且指定到当时版本状态，这样看到的代码是对应引用的版本号。

另外如果我们要修改对应版本怎么办，很简单，先递归下载所有项目，之后再进入子模块，使用git reset --hard 来切换版本。之后进行add commit push一系列操作就可以。

但是还有个文件就是：如果子模块被调用后又原子模块又发生了更新，如何更新到最新版本，这可能要是另外研究一下。这可以在基础操作熟练之后，或者是遇到这个问题了再学习琢磨。

=====================

删除submodule的操作：

cd mainproject

git rm –cached submodule

rm -rf submodule

git commit -m "del submodule" 

git push