为何Git无法完整下载submodule依赖库？（版本1.8.3.1）

核心原因 #

你遇到的问题本质是Git版本过旧：你的Git 1.8.3.1是2013年的老旧版本，完全不支持现代Git生态中的大文件存储（Git LFS）特性，同时对submodule的递归逻辑、参数行为的支持也存在缺陷。那些130字节左右的文件并非实际静态库，而是Git LFS的指针文件——老版本Git无法识别这些指针，自然不会拉取背后的真实大文件。

另外，你使用的git submodule update --init --remote --recursive命令中，--remote参数在Git 1.8.x版本中的行为与新版差异极大，可能导致子模块未正确切换到指定分支拉取完整内容。

解决步骤 #

1. 升级Git版本 #

Git 1.8.x已停止维护，必须升级到2.10以上的稳定版（推荐最新LTS版本），不同系统的升级方式：

• CentOS/RHEL：通过IUS仓库安装，例如sudo yum install git224（根据仓库提供的版本调整）
• Ubuntu/Debian：执行sudo apt update && sudo apt install git
• macOS：使用Homebrew执行brew install git
• Windows：直接从Git官方渠道下载安装包

2. 配置Git LFS（若子模块使用了大文件存储） #

如果你的依赖库通过Git LFS托管，升级Git后还需安装并配置LFS：

# 全局初始化Git LFS
git lfs install
# 进入主仓库，重新拉取子模块及LFS内容
cd your-repo
git submodule update --init --recursive
git lfs pull --recurse-submodules

3. 新版Git下的正确克隆流程 #

若重新克隆项目，用以下命令确保完整拉取所有内容：

# 先初始化LFS
git lfs install
# 递归克隆主仓库、子模块，并自动拉取LFS大文件
git clone --recurse-submodules <你的仓库地址>

验证方式 #

拉取完成后执行ls -lh查看静态库文件大小，若与你提供的实际尺寸一致，即说明操作成功。

内容的提问来源于stack exchange，提问作者Yongqi Z