为何无法将Gradle Checkstyle插件的toolVersion替换为plugins块的version？

这个问题我太熟了！本质是你混淆了Gradle插件版本和Checkstyle工具本身的版本两个概念，还没搞清楚Gradle核心插件的特性，我给你拆解清楚：

1. Checkstyle是Gradle核心插件，版本和Gradle强绑定 #

Checkstyle属于Gradle官方维护的核心插件，这类插件是Gradle发行版自带的——每一个Gradle版本都会对应固定版本的核心Checkstyle插件，你没办法在plugins块里给它单独指定version参数，这就是你收到报错的直接原因。

你原来用的apply plugin: 'checkstyle'是旧版应用核心插件的方式，它同样不需要指定插件版本，因为默认就用Gradle自带的对应版本。

2. toolVersion和插件版本是两回事 #

你原来配置里的toolVersion = '7.3'，不是用来指定Gradle的Checkstyle插件版本，而是用来指定代码检查工具Checkstyle本身的版本（就是那个负责扫描代码的Checkstyle程序版本）。

当你切换到plugins块的写法后，这个配置完全可以保留，它的作用和之前一模一样——让Gradle使用你指定的7.3版本的Checkstyle工具来做代码检查。

正确的配置写法 #

你只需要去掉plugins块里的version参数，保留checkstyle配置块里的toolVersion即可：

plugins {
    id 'checkstyle' // 核心插件无需指定version，使用Gradle自带的插件版本
}

checkstyle {
    toolVersion = '7.3' // 这里继续指定Checkstyle工具的版本，和原配置作用一致
    // 你的其他配置项...
}

额外说明：如果想自定义Checkstyle插件版本怎么办？ #

如果你的需求是要使用某个特定版本的Gradle Checkstyle插件（而非Checkstyle工具版本），那你不能用核心插件，得改用第三方维护的Checkstyle插件，写法类似：

plugins {
    id 'com.puppycrawl.tools.checkstyle' version '9.3' // 这是第三方插件，可以指定版本
}

不过一般来说，使用Gradle核心插件+指定toolVersion就足够满足大部分代码检查需求了。

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