Gradle是通用构建工具，Java版本需通过启用java插件并设置sourceCompatibility与targetCompatibility指定；编译不依赖JAVA_HOME，而是由Gradle自行管理JDK；implementation与compileOnly分别控制依赖的传递性与编译期可见性。
Gradle 不是 Java 的构建工具，而是通用构建工具；它用 Groovy 或 Kotlin DSL 写配置，不是 Java 代码本身
build.gradle 里怎么指定 Java 版本？
Java 版本由 java 插件控制，不是靠 sourceCompatibility 单独生效——必须先应用插件。常见错误是只设了兼容性却没启用插件，导致编译仍用默认 JDK。
- 用
plugins { id 'java' }启用标准 Java 插件（推荐方式） - 再设置
java.sourceCompatibility = JavaVersion.VERSION_17和java.targetCompatibility = JavaVersion.VERSION_17 - 如果项目用 JDK 21 编译但要跑在 JDK 17 上，
targetCompatibility必须显式设为VERSION_17，否则生成的字节码可能含不兼容指令 - Gradle 8.4+ 默认使用
--release编译参数，所以sourceCompatibility还会影响可调用的 API 范围
为什么 compileJava 任务不读 JAVA_HOME？
Gradle 默认用自己下载的 JDK（通过 gradle.properties 中的 org.gradle.java.home 或 wrapper 自动管理），而不是系统 JAVA_HOME。这常导致本地编译结果和 CI 不一致。
ImageMagick 批处理处理器
下载
使用 ImageMagick 的 convert 和 mogrify 命令进行批量图像处理，支持调整大小、裁剪、水印和格式转换。与 libvips 集成以实现高性能缩略图生成。
- 检查当前用的 JDK：运行
./gradlew --version看 “JVM:” 行 - 强制指定 JDK 路径：在项目根目录
gradle.properties加org.gradle.java.home=/path/to/jdk-17 - 若用 JDK 21 的新特性（如虚拟线程），还需在
compileJava里加 JVM 参数：options.fork = true; options.forkOptions.jvmArgs = ['--enable-preview']
dependencies 块里 implementation 和 compileOnly 有什么区别？
这是类路径隔离的核心机制，直接影响打包大小、运行时类冲突和 IDE 导入行为。
立即学习“Java免费学习笔记（深入）”；
-
implementation：依赖参与编译，但不传递给下游模块（比如 A → B → C，B 用implementation引入 log4j，则 C 看不到 log4j） -
compileOnly：只用于编译期（如 Lombok 注解处理器），不会打进 jar，运行时也不加载 - 误用
compileOnly替代runtimeOnly是高频坑：后者是运行时才需要（如 JDBC 驱动），前者根本不会出现在 classpath 里 - Spring Boot 项目中，
spring-boot-starter-web应该用implementation，而lombok推荐用compileOnly+annotationProcessor组合
Gradle 的 DSL 看似简单，但每个配置项背后都对应着 Task 执行图、Classloader 隔离策略和 JVM 启动参数——改一个 sourceCompatibility 可能让单元测试在 CI 上突然失败，因为用了本地 JDK 未启用的预览特性。
