git clone 报错处理和submodule子模块的添加

最新推荐文章于 2025-06-24 14:35:16 发布

清幽小路

最新推荐文章于 2025-06-24 14:35:16 发布

阅读量2k

点赞数

CC 4.0 BY-SA版权

分类专栏：工程

本文链接：https://blog.youkuaiyun.com/weixin_43192983/article/details/117990322

本文介绍了在执行`git clone`时遇到的代理错误问题，问题源于http代理配置错误为https。解决方案包括取消代理配置或正确设置代理。此外，还详细讲解了如何在克隆仓库后初始化并更新Git子模块，包括运行`git submodule init`和`git submodule update`两个命令。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

git clone 报错

error message：
fatal: unable to access 'https://github.com/xxx.git/': gnutls_handshake() failed: The TLS connection was non-properly terminated.

问题：代理设置有错，为 http 错误配置了 https 的代理，导致出错。

解决方法：
如果没有配置代理，用以下命令取消代理：

git config --global  --unset https.https://github.com.proxy
git config --global  --unset http.https://github.com.proxy

如果需要使用代理，使用 8080 端口为例：

http 协议通过以下命令配置

git config --global http.https://github.com.proxy http://127.0.0.1:8080
git config --global https.https://github.com.proxy https://127.0.0.1:8080

socket 协议通过以下命令配置

最低0.47元/天解锁文章

200万优质内容无限畅学

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

清幽小路

关注关注

0
点赞
踩
2

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

【git】Git Submodule管理项目子模块

九师兄

10-24

1842

1.概述参考：https://www.cnblogs.com/nicksheng/p/6201711.html 并且修改。 2. 使用场景当项目越来越庞大之后，不可避免的要拆分成多个子模块，我们希望各个子模块有独立的版本管理，并且由专门的人去维护，这时候我们就要用到git的submodule功能。常用命令 git clone <repository> --recursive 递归的方式克隆整个项目 git submodule add <repository> <path.

git代码clone，submodule

09-11

git代码检出、colone、切换分支，初始化所有子模块，将父模块的代码检出至本地等。

参与评论您还未登录，请先登录后发表或查看评论

error: submodule git dir ‘D:/xx/.git/modules/source/xx/common_shared‘ is inside git dir

aduzhe的专栏

06-06

321

我们只需要在.git\modules/ 删除旧的submodule路径即可，我这里是 product_src。其实这是因为我们改了submodule 的路径，导致submodule 映射到两个路径。拉去新的submodule时报错。

Git 子模块 (Submodule) 完全使用指南

最新发布

06-24

1258

Git 子模块模式允许你将一个 Git 仓库作为另一个 Git 仓库的子目录。这篇文章教你用 Git 命令行和 TortoiseGit 两种方式做三件事：添加一个新的子模块；克隆与更新含有子模块的项目；修改、提交和推送子模块

git clone命令_Git Submodule 命令与理解

weixin_39943370的博客

11-29

3972

TL;DR# Add submodule git submodule add 定义git submodule允许用户将一个 Git 仓库作为另一个 Git 仓库的子目录。它能让你将另一个仓库克隆到自己的项目中，同时还保持提交的独立性。作用在我这里，它的作用非常明确，即给在各个项目中都会用到的代码段一个公共栖息地，做到“一处改，处处改”。常用命令添加git submodule add# 直接c...

【Git学习】Git如何Clone带有Submodule的仓库？

字节卷动

02-13

5631

学习如何clone带有submodule的仓库，主模块和子模块的仓库是两个不同的仓库

【git】submodule

DMLearner的博客

09-27

1135

(1) 项目很大参与开发人员多的时候，需要将各个模块文件进行抽离单独管理。(2) 使用 git submodule 来对项目文件做成模块抽离，抽离出来的文件可单独成为一个 git 仓库。整个主项目对抽离出来的子项目（子模块）有依赖关系，却又并不关心子项目（子模块）的内部开发流程细节。(3) 代码如果全员可见，可以做成分支进行管理；如果代码不可见，可以创建为子仓库（独立一个git 仓库）；子仓库管理模块代码，主仓库定时更新。(4) 简单理解：项目工程为一个仓库；模块为一个仓库；

git clone 子模块没下载全的问题解决

10-14

总结一下，当使用`git clone`克隆一个包含子模块的项目时，如果因为网络或其它原因导致子模块没有下载完全，可以采用`git submodule update --init --recursive`命令来确保子模块被完整下载并正确初始化。...

git常用操作及git submodule子模块操作和简单讲解，git源码包下载镜像网站推荐，编译安装git，配置git局域网ssh服务端免密操作

qq_41634188的博客

08-01

1162

讲解源码包编译安装git，git涉服务端操作免密以及git常用操作和git submodule子模块操作和讲解。

git submodule 删掉 submodule，之后，尝试重新添加，报错 “A git directory for ‘‘’‘’‘ is found locally with remote(s)”

shimly123456的博客

08-13

855

手动删除干净之后，再次 git submodule add ，发现能够成功。确定 .git/modules/…/ 相关文件夹被删掉了（重点）还有子模块之前在 repo 里占据的文件夹，这也是肯定要删除干净的。确定 .gitmodules 里的相关部分删干净了。这是因为i删除的时候没有删干净。

[github]——克隆带有submodule的仓库

jokerxsy的博客

03-12

1205

前言碰到一个仓库，里面带有这样的文件: Clone带有Submodule的仓库克隆整个项目: git clone 你要克隆的项目 cd 你克隆了的项目 git submodule // 查看submodule的状态 >-一串hash码文件目录前面的减号意味着: 该子模块还没有检出所以要检出该子模块: git submodule init >Submodule ... git submodule update >Cloning into ... 参考云水——Git S

git clone 失败，解决方法之一

东方

06-03

3万+

git clone 失败，解决方法之一最近写了一小段代码，想上传到GitHub上。然而，git clone的时候出现了状况。clone到本地时速度超级慢，等了两三个小时，显示克隆失败，见下图：百度找了各种方法，比如把https改成git、修改 Compressing 的值、重新设置通信缓存的值都没有任何效果。排查过程： 1.是Git工具的问题还是自己的GitHub仓库的问题？可以在G...

git clone 子模块

huanleyan的专栏

02-20

820

git clone --recursive ssh://git@xxxxx.git

git clone 含有子模块的项目

wmy19890322的专栏

11-25

2203

当一个 git 正常 cloen 项目包含子模块（submodule) 时，直接克隆下来的子模块目录里面是空的。

git submodules

我的博客

02-05

707

当代码仓库中包含文件时，这意味着该仓库使用了 Git 子模块（Git Submodules）。文件记录了子模块的相关信息，如子模块的仓库地址、路径等。

git submodule 只clone单个module

Yonggie的博客

05-18

509

参考：https://stackoverflow.com/questions/16728866/how-to-only-update-specific-git-submodules。

解决github无法拉取submodule子模块的问题

qq_45523675的博客

07-11

8363

当使用拉去一个配置了子模块的仓库后，即使使用了科学上网也有可能不能够成功将仓库拉取下来，这可能是因为科学上网的不稳定性等导致的。同时在使用git clone拉去https的url时，同样可能会出现一直卡在本文提供一个简单的脚本来解决该问题。

git下载子模块命令git clone --recursive和git submodule update --init

热门推荐

cumtchw

11-18

3万+

目录方法一：git clone --recursive 方法二：git submodule update --init 有时github上的工程可能会包含一些子模块，例如这时候如果你只是用下面的命令下载， git clonehttps://github.com/Cambricon/CNStream 下载完之后会发现easydk文件夹是空的，有两种方法下载子模块 方法一：git clone --recursive git clone --recursivehttps:...

Appears to be a git repo or submodule

u011149565的博客

09-05

1394

由于react-native需要引入大量的第三方包，不少包作者误把包项目得.git文件上传到github，导致下载新的npm包时报错npm err: xxxxAppears to be a git repo or submodule. 解决方式： rm -rf node_modules/*/.git ...

git clone submodule

08-17

在使用git clone命令时，如果需要同时获取子模块的仓库，有以下几种方法可以实现。一种方法是先使用git clone命令来抓取主项目A的代码仓库，然后再使用git submodule init和git submodule update来获取子模块。具体操作步骤如下：先执行git clone projectA.git命令来克隆主项目A的代码仓库，然后进入项目A的目录，再执行git submodule init和git submodule update命令来获取子模块的代码仓库。另一种方法是在当前主项目的目录下直接执行git submodule init和git submodule update命令来获取子模块的代码仓库。还有一种方法是在使用git clone命令时，加上--recurse-submodules或--recursive这样的递归参数，例如git clone --recursive projectA.git，这样就可以同时获取主项目和子模块的代码仓库。123 #### 引用[.reference_title] - *1* *3* [git submodule使用以及注意事项](https://blog.youkuaiyun.com/xuanwolanxue/article/details/80609986)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v92^chatsearchT0_1"}}] [.reference_item style="max-width: 50%"] - *2* [Git中submodule的使用](https://blog.youkuaiyun.com/liyuan_669/article/details/121105252)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v92^chatsearchT0_1"}}] [.reference_item style="max-width: 50%"] [ .reference_list ]