Git submodule !Unable to checkout !应对办法

最新推荐文章于 2025-05-20 18:35:29 发布

Yew1168

最新推荐文章于 2025-05-20 18:35:29 发布

阅读量8.4k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： Git

本文链接：https://blog.csdn.net/yaoyutian/article/details/104603915

Git 专栏收录该内容

13 篇文章

订阅专栏

本文提供了一套详细的步骤来解决从GitHub克隆仓库时，因网络问题导致的Git子模块下载失败的情况。通过重置子模块、检出正确分支、更新子模块至指定commit，最终确保子仓库的状态与主仓库同步。

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

从github克隆使用了git子模块的仓库，因网络问题导致子仓库下载出错，命令行里会提示如：

Unable to checkout '726d14d02c95bb21ec9e43807751b491d295dd3c' in submodule path 'third_party/ktx'

解决办法：

1.进入子模块目录，重置

git reset --hard

2.检出确认

git checkout master

3.返回主仓库目录，查看状态；提示子仓库有修改，一般commit号不对应

$ git status
On branch master
Your branch is up to date with 'origin/master'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

        modified:   third_party/ktx (new commits)

4.更新子模块，匹配commit

$ git submodule update
Submodule path 'third_party/ktx': checked out '726d14d02c95bb21ec9e43807751b491d295dd3c'

5.确认

$ git status
On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

Yew1168

关注关注

1
点赞
踩
8

收藏

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

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

Modelsim安装问题，Unable to checkout a license.解决方法

m0_58207226的博客

03-12

8282

本文介绍了安装Modelsim软件后仍然打不开、产生Unable to checkout a license报错的解决方法。

git submodule在jenkins上使用的坑

ZyManTou的博客

03-28

3327

submodule是个好东西，配合构建工具的模块化功能在提取代码公共模块非常好用本地用起来虽然非常爽，但是如果配合jenkins自动化构建就会有一些坑例如子模块的分支选取，递归update，等问题默认submodule的分支选取是坑爹的，如果不指定分支则会读取master分支下的代码或者是head游离态下的代码下面贴下jenkinsfile拉取代码部分的脚本 checkout scm g...

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

【Git】Git submodule常用指令

All_In_gzx_cc的博客

12-13

7459

文章出自个人博客 https://knightyun.github.io/2021/03/21/git-submodule，总结的很详细，本文只做学习记录，方便自己查阅~

Modelsim 找不到LICENSE，出现Unable to checkout a viewer license可能是虚拟机的虚拟网卡未禁用

weixin_74057844的博客

05-20

716

如图，在安装Modeksim时，许多人可能会遇到如下问题，明明自己已经按照教程设置好了环境变量，却依然出现“Unable to checkout a license. Make sure your license file environment variable (e.g., LM_LICENSE_FILE) is set correctly”字样。主要简单讲一下第4种。如图，此电脑右键选择管理，设备管理器找到网络适配器，可以按照图中的禁用选择操作，之后重新生成LICENSE即可。

[git报错] fatal: reference is not a tree: xxx 以及 Unable to checkout ‘xxx‘ in submodule path xxx

后厂村路蔡徐坤的博客

10-04

1874

https://dalewushuang.blog.csdn.net/article/details/107683908

[解决方案] [git报错] fatal: reference is not a tree: xxx 以及 Unable to checkout ‘xxx‘ in submodule path xxx

the Blog of 等不到天亮丶等时光

07-30

1万+

本文旨在解决如题所示的问题。（预告：是由`--depth 1`这个参数和git版本导致的）

git clone报错：fatal: unable to checkout working tree

xiaoshandong87的专栏

02-23

2026

error: invalid path 'dist/storage/assets/tenant/demo_gc/建筑/con.jpg'在windows操作系统下，拉取代码，错误信息如下。需要对git做如下配置。

Git Submodule 更新子库失败 fatal: Unable to fetch in submodule path

极客七

08-06

1330

在 [submodule “Assets/CommonModule”] 项下加入。编辑本地目录 .git/config 文件。

swe_dev@swe-vm:~/My_Project/swe_zhiti/can_bridge$ git submodule update --init --recursive error: Your local changes to the following files would be overwritten by checkout: utils/fsm_event_dispatcher/fsm_event_dispatcher.hpp Please commit your changes or stash them before you switch branches. Aborting error: Your local changes to the following files would be overwritten by checkout: tasks/auto_driving_fsm/auto_driving_fsm_task.hpp tasks/auto_driving_fsm/fsm_autodrivingfsm.hpp tasks/can_bridge/ipc_receive_task.hpp tasks/control_shield/event_driver_take_over.hpp tasks/control_shield/mode_auto_driving_control2can_task.hpp tasks/control_shield/mode_debug_task.hpp tasks/control_shield/mode_handshake_task.hpp Please commit your changes or stash them before you switch branches. Aborting Unable to checkout '729bb24def5f4a4aad74c3e839eb332ef7defdd4' in submodule path 'cc_mid' Unable to checkout '655055a69d4b67a148d5d02d54af89a267a3b2d6' in submodule path 'src/calmcar_app_store'

最新发布

07-15

git submodule deinit -f path/to/submodule rm -rf .git/modules/path/to/submodule git submodule update --init --recursive ``` > **关键提示**：子模块本质是独立仓库，任何修改都应通过标准Git流程管理。主...

在安装grpc 1.43.2的时候运行git submodule update --init --recursive报克隆失败

03-01

`SSL certificate problem: unable to get local issuer certificate` **解决方案**： ```bash # 关闭SSL验证（临时方案） git config --global http.sslVerify false # 或安装CA证书（推荐） sudo apt install ...

把本地项目某个文件夹submodule化

Moria

08-16

2411

本文章包含了git代码迁移至新仓库、git submodule 业务需求：将别人代码中的某部分的功能嵌入本项目中，经讨论如果直接拷贝所需功能代码到本项目，后续无法保证双方功能一致。结果：我们重新建一个新的仓库和他们的代码保持一致，在新的仓库中将需要的代码submodule化，之后再将submodule模块引入到我们所需的项目中。我也没有接触过，按网上大神给出的案例实践出的报错信息和结果总结一份。...

git-checkout-submodule-action:GitHub动作，用于检出子模块

05-26

检出子模块动作递归检出存储库中的所有子模块。 steps : - name : Checkout repository uses : actions/checkout@master - name : Checkout submodules uses : textbook/git-checkout-submodule-action@master 2.1.0版中的新功能。您可以选择设置标志： steps : - name : Checkout repository uses : actions/checkout@v2 - name : Checkout submodules uses : textbook/git-checkout-submodule-action@master with : remote : true 备择方案您可以将submodu

由于我在autodl租的服务器无法访问gitlab，我已经将eigen拉到了本地，如何使lietorch访问我本地的eigen文件夹，而不访问gitlab，报错如下：(mast3r-slam) root@autodl-container-cc3746a64c-4c1769bd:~/MASt3R-SLAM# pip install --no-build-isolation -e . Looking in indexes: http://mirrors.aliyun.com/pypi/simple Obtaining file:///root/MASt3R-SLAM Checking if build backend supports build_editable ... done Preparing editable metadata (pyproject.toml) ... done Collecting lietorch@ git+https://github.com/princeton-vl/lietorch.git (from MAST3R-SLAM==0.0.1) Cloning https://github.com/princeton-vl/lietorch.git to /tmp/pip-install-f0x_dt_2/lietorch_04351692bdf34ddb927c576984b5b361 Running command git clone --filter=blob:none --quiet https://github.com/princeton-vl/lietorch.git /tmp/pip-install-f0x_dt_2/lietorch_04351692bdf34ddb927c576984b5b361 Resolved https://github.com/princeton-vl/lietorch.git to commit 0fa9ce8ffca86d985eca9e189a99690d6f3d4df6 Running command git submodule update --init --recursive -q fatal: unable to access 'https://gitlab.com/libeigen/eigen.git/': The requested URL returned error: 503 fatal: clone of 'https://gitlab.com/libeigen/eigen.git' into submodule path '/tmp/pip-install-f0x_dt_2/lietorch_04351692bdf34ddb927c576984b5b361/eigen' failed Failed to clone 'eigen'. Retry scheduled fatal: unable to access 'https://gitlab.com/libeigen/eigen.git/': The requested URL returned error: 503 fatal: clone of 'https://gitlab.com/libeigen/eigen.git' into submodule path '/tmp/pip-install-f0x_dt_2/lietorch_04351692bdf34ddb927c576984b5b361/eigen' failed Failed to clone 'eigen' a second time, aborting error: subprocess-exited-with-error × git submodule update --init --recursive -q did not run successfully. │ exit code: 1 ╰─> See above for output. note: This error originates from a subprocess, and is likely not a problem with pip. error: subprocess-exited-with-error × git submodule update --init --recursive -q did not run successfully. │ exit code: 1 ╰─> See above for output.

03-31

git checkout <commit-hash> # 替换为lietorch要求的commit ``` ### 关键点说明 1. **本地路径协议**：必须使用`file://`协议指定本地路径，确保Git识别为本地仓库。 2. **权限问题**：确保Autodl服务器对本地Eigen...

git报错：fatal：unable to checkout working tree

xiaban_的博客

07-13

1086

拉取后文件夹在只有.git文件夹，且再次执行git pull也会显示都是最新的了。

打开modelsim 提示 Unable to checkout a viewer license necessary xxxxxxxx