克隆含Gradle可执行文件的Git项目后执行./gradle -v报错求助
2026-8-26
问题根源排查与解决思路
1. Git操作顺序完全颠倒（最核心原因）
你当前的操作流程是先执行git submodule update --init再克隆主项目，这是错误的。Submodule是依附于主项目存在的，主项目根目录下的.gitmodules文件才定义了submodule的地址和对应路径。正确流程应该是：
- 先执行
git clone <project URL>克隆主项目 - 进入主项目目录后，再执行
git submodule update --init --recursive（加--recursive确保嵌套submodule也能拉取完整）
你之前的操作相当于在空目录执行submodule更新，根本找不到对应的配置文件，拉取的Gradle依赖必然不完整，缺少核心lib包，自然会出现找不到主类的报错。
2. Gradle发行包文件拉取不完整
如果操作顺序没问题，那大概率是Git拉取时Gradle目录下的核心文件缺失，尤其是lib文件夹内的gradle-launcher-xxx.jar这类关键jar包：
- 对比老同事本地Gradle目录的
lib文件夹，检查自己本地的jar包数量和完整性； - 强制重新拉取submodule：先执行
git submodule deinit -f <gradle对应的submodule路径>，再执行git submodule update --init重新拉取。
3. Git换行符配置损坏文件
Git的core.autocrlf配置不当会修改脚本或二进制文件内容：
- 比如Windows下设置
core.autocrlf=true，会把Gradle脚本（gradle/gradle.bat）的LF换行符转成CRLF，甚至损坏二进制jar包； - 执行
git config --global core.autocrlf查看当前配置，建议Linux/Mac设为input，Windows设为false，避免修改二进制文件； - 重新克隆项目，确保文件未被换行符转换损坏。
4. Submodule权限或浅克隆限制
- 确认你对Gradle所在的submodule私有仓库有完整拉取权限，部分私有仓库会限制新用户的拉取范围；
- 克隆主项目时避免浅克隆，执行
git clone --no-shallow <project URL>，防止因拉取深度不够导致文件缺失。
内容的提问来源于stack exchange，提问作者Azii
相关产品推荐
相关产品推荐
