在Gradle中需显式配置compileJava.options.compilerArgs添加参数，如--enable-preview和--release，二者缺一不可；还需注意IDE与Gradle配置分离、避免覆盖、多sourceSet需分别配置，并通过--info确认实际生效参数。
compileJava任务里加options.compilerArgs
Gradle默认用javac编译Java源码，但不会自动传入任何额外参数。要加参数，必须显式修改compileJava这个Task的options.compilerArgs列表。直接在build.gradle里写就行，不需要插件或额外依赖。
常见错误是把参数塞进tasks.withType(JavaCompile)却漏掉all { ... }闭包，或者误用systemProperties——那只会传给Gradle Daemon，不是javac。
-
compileJava.options.compilerArgs.addAll(['-Xlint:unchecked', '-g'])：开启泛型检查和调试信息 -
compileJava.options.compilerArgs += ['-Werror']：把所有警告当错误（慎用，CI容易挂） - 多个参数别拼成一个字符串，比如
['-Xlint:all']可以，但['-Xlint:all -g']会失败
启用预览特性必须配--enable-preview和--release
Java 14+的预览特性（如record、switch表达式、结构化并发）光靠JDK版本不够，javac必须同时看到--enable-preview和--release才认。
只加--enable-preview会报错：error: preview features are not enabled；只加--release则压根不识别预览语法。
立即学习“Java免费学习笔记（深入）”；
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
-
options.compilerArgs.addAll(['--release', '21', '--enable-preview'])：顺序无关，但两个都得有 - 如果还用了孵化器模块（如
jdk.incubator.foreign），得额外加--add-modules - 运行时也得加
--enable-preview，否则java.lang.UnsupportedOperationException: Preview features are not enabled
IDEA里设置和Gradle配置不是一回事
IntelliJ IDEA的Settings → Build → Java Compiler → Additional command line parameters只影响IDE内嵌编译器，不影响./gradlew compileJava。两者参数不共享，改了IDE设置不等于Gradle构建就生效。
尤其容易踩坑的是：本地IDE能编译过，CI跑./gradlew build却失败——大概率就是只配了IDE没配Gradle。
- 确认方式：执行
./gradlew compileJava --info，看日志里Compiler arguments是否包含你要的参数 - Android项目还要注意：
android.compileOptions是给旧版AGP用的，新项目优先走compileJava配置 - 如果用Kotlin混合项目，
kotlinOptions.jvmTarget和compileJava的--release要对齐，否则字节码版本冲突
避免compilerArgs被覆盖的写法
有些插件（比如Lombok的io.freefair.lombok）或旧版Gradle脚本会重置compilerArgs，导致你加的参数消失。最稳的方式是用all { ... }确保每次执行都追加。
别这么写：compileJava.options.compilerArgs = ['-Xlint']——这是赋值，会清空默认值。
- 正确写法：
compileJava { options.compilerArgs.addAll(['-Xlint:deprecation']) } - 更安全写法：
tasks.withType(JavaCompile).configureEach { options.compilerArgs += ['-Xlint:serial'] }（Gradle 6.0+） - 如果项目有多个sourceSet（如test），记得单独配
compileTestJava，否则测试代码不生效
真正麻烦的从来不是加参数，而是参数生效范围不一致——IDE、Gradle命令、CI环境、甚至不同Gradle版本对compilerArgs的处理逻辑都有细微差别。每次加完，务必用--info看实际传给javac的完整命令行。
