![cover](https://img-blog.csdnimg.cn/c0c7a899b5fb4a2d8258c831206e82ee.png)
git submodule update --init --recursive失败的处理办法
git submodule update --init --recursive失败的处理办法。
前言
由于国内网络环境的影响,我们从 github clone 代码时,总是会出现 clone 失败的情况。当 clone失败时,我们怎么处理解决呢?以下总结了三种解决办法,仅供参考交流。
1 clone事例
这里,我以获取乐鑫提供的软件库文件 ESP-IDF 仓库。作为 clone 的事例,具体讲解当 clone 失败时,怎么解决问题。
获取 ESP-IDF 的本地副本:打开终端,切换到要保存 ESP-IDF 的工作目录,使用 git clone
命令克隆远程仓库。
打开终端,输入以下命令:
mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git
ESP-IDF 将下载至 ~/esp/esp-idf
。
2 Failed to clone
受到网络环境的影响,代码一次性克隆成功,基本属于中彩票。经常会出现子模块 clone 失败的情况。即报错:Failed to clone...
这种问题,大多由于网络不稳定或者无法访问 github 子模块网络,我们首先多尝试 clone几次(说不定网络稳定一会儿,就能 clone 成功),具体步骤如下:
(1) 切换到 esp-idf 代码目录下;
cd esp-idf/
(2) 查看当前本地分支状态;
git status
git 会提示,当前本地分支与远程分支的不一致性(红色字体部分),也就是我们 clone 失败的具体组件部分。
(3) 我们再次输入子模块更新下载指令,尝试从远端仓库 clone 代码;
git submodule update --init --recursive
不用担心重复下载,已经 clone 成功的代码,会自动跳过。
在网络状况良好的情况下,多尝试几次,基本就能 clone 成功。但是,也有可能出现下面的情况,我称之为“假象 clone”。
3 假象clone的处理方法
(1) 经过多次的重复 clone 子模块,git 已经不再下载新的代码,貌似我们已经成功 clone 所有远端仓库;
(2) 我们再次输入本地分支状态查看命令,发现 git 提示了很多“不一致性”;
也就是说我们本地分支和远端分支还是不同,我们没有 clone 成功,可是为什么 clone 子模块的命令不再生效呢?
根据提示路径,我们可以找到不一致模块的文件夹,发现里面只有一个空目录。我们使用快捷键 CTRL+H,发现文件夹里面有以 . 开头的隐藏文件(比如 .git)。
这里我猜测 clone 命令不再有效的原因是:.git 中记录该子模块的版本信息,所以当 git 命令,扫描到该子模块时,已经有文件夹和版本信息,所以不再 clone,认为已经存在。(如果有同学知道这部分机制,欢迎评论留言)
(3) 既然 git 扫描的依据是:文件夹 + .git,那么我们将不一致模块的最后一级文件夹删除即可;
(4) 删除以后,再次输入更新下载子模块的命令;
git submodule update --init --recursive
可以看到,刚才删除的子模块再次被下载,并切换到相应的最新分支。
(5) 最后,输入查看本地分支状态的命令;
git status
提示:nothing to commit,working tree clean.
翻译过来的意思就是:没有需要提交的代码,本地工作的树很干净,和远端仓库代码一致。
至此,通过以上两种办法的交替,多次使用,基本能 clone 成功,就是比较耗费时间。
4 网络问题
有些代码,经过以上两种办法还是无法 clone 成功。那没办法了,基本就是网络问题。
这里推荐大家一个小工具(科学上网),作者亲自尝试以后,基本能访问 google 和 YouTube,说明效果还是不错的。
总结
以上就是 git submodule update --init --recursive 失败的时候,三种处理方法。推荐先尝试第三种方法,毕竟咱们的时间就是金钱。
![Logo](https://devpress.csdnimg.cn/79de2bf0b7994defa4242ef90d5513fa.jpg)
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)