gradlew --version与gradle wrapper --version版本不一致的原因

两个命令输出版本不同属于正常设计表现，本质是二者调用的是完全独立的两个Gradle运行实例：

• 执行gradle wrapper --version时，--version作为Gradle CLI的高优先级参数，会直接触发版本查询逻辑后退出，根本不会执行wrapper这个构建任务，本质调用的是你系统全局安装的Gradle程序，输出的是全局环境配置的Gradle本体版本。这个版本由你系统里配置的GRADLE_HOME环境变量、PATH路径中的Gradle寻址位置决定，和你当前打开的项目没有绑定关系，全局升级Gradle时这个版本会同步变化。
• 执行gradlew --version时，触发的是当前项目根目录下自带的Gradle Wrapper（Gradle包装器）脚本，输出的是当前项目强制锁定使用的Gradle版本。Wrapper本身就是为了解决不同项目Gradle版本不兼容的问题设计的，它的指定版本存放在项目gradle/wrapper/gradle-wrapper.properties配置文件中，不会跟着全局Gradle的升级自动变动，能保证所有拉取项目的开发者用完全一致的Gradle版本构建，避免版本差异导致的构建失败。

从你提供的版本对比截图也能看出，两个命令对应的可执行文件路径完全不同，不存在版本冲突或者安装错误的问题。

常见场景参考：如果你全局安装的是Gradle 8.7，但是手上维护的3个老项目分别用Wrapper锁定了7.4、7.6、8.0三个版本，那你在对应项目目录下执行gradlew --version就会分别输出对应的锁定版本，和全局版本不一致是完全符合预期的。如果需要升级项目的Wrapper版本，在项目目录下执行全局Gradle的gradle wrapper --gradle-version=目标版本号命令，就会更新Wrapper对应的配置和脚本。

内容的提问来源于stack exchange，提问作者Jordan Tan Jun Wen