必须安装redhat.java和fwcd.kotlin插件并禁用冲突插件；gradle版本需≥6.0；不可手动import gradle api类；刷新项目或运行ktlint可恢复补全。
Gradle Kotlin DSL文件没语法高亮？先确认插件装对了
VSCode 默认不识别 build.gradle.kts，不是配置问题，是根本没装对语言支持。Kotlin 插件（如 “Kotlin Language”）只管 .kt 文件，不管 Gradle 的 DSL 变体；而 “Gradle for Java” 插件默认也不处理 .kts 脚本。
必须装两个插件并确保启用顺序正确：
- 安装
redhat.java（Java 扩展包，含基础 Gradle 支持） - 安装
fwcd.kotlin（目前最稳定的 Kotlin 语法支持，比官方插件更早适配 DSL 场景） - 禁用或卸载其他 Kotlin 相关插件（比如
mathiasfrohlich.Kotlin），它们会和fwcd.kotlin冲突，导致build.gradle.kts被识别成纯 Kotlin 文件，失去 Gradle 特有语义（如dependencies块补全）
build.gradle.kts 里 import 报红、函数没补全？检查 Gradle 版本与 Kotlin DSL 兼容性
Gradle Kotlin DSL 不是“写完就跑”，它依赖 Gradle 自身的 Kotlin 编译器版本和 API 绑定。常见现象：plugins 块里写 id("org.springframework.boot") 没提示，或 implementation 函数标红——这往往不是 VSCode 的锅，而是项目用的 Gradle 太老，没导出足够 DSL 符号。
最低兼容要求：
- Gradle 6.0+ 才正式稳定支持 Kotlin DSL
- Gradle 7.0+ 开始为常用插件（如 Spring Boot、Kotlin JVM）生成更完整的
PluginDependenciesSpec补全支持 - 如果用的是 Gradle 5.x，即使插件装全，
dependencies块内也大概率只有基础 Kotlin 语法高亮，没有 Gradle 特有函数补全
验证方式：在终端运行 ./gradlew --version，输出中 Gradle 行必须 ≥ 6.0。
import org.gradle.api.tasks.bundling.Jar 报错？DSL 中不能直接 import Gradle API 类型
Kotlin DSL 的核心机制是委托（delegation）+ 隐式接收者，不是传统 Kotlin 脚本。你写的 tasks.named<jar>("jar")</jar> 看似用了 Jar 类，实际是通过 Gradle 的类型安全模型自动解析的，不需要、也不能手动 import 这些类型。
常见误操作及后果：
- 手动加
import org.gradle.api.tasks.bundling.Jar→ VSCode 不报错但 Gradle 构建失败，提示 “Cannot access class 'Jar'” - 在
buildSrc里写build.gradle.kts并尝试 import → 同样失败，因为buildSrc的编译类路径由 Gradle 自动管理，不走普通 Kotlin 编译流程 - 正确做法：删掉所有针对 Gradle API 的
import，依赖 DSL 提供的隐式作用域，比如直接写tasks.named<zip>("distZip")</zip>
修改 build.gradle.kts 后补全延迟或失效？别靠重启 VSCode，试试这个刷新动作
Gradle Kotlin DSL 的语义补全是靠 Gradle 启动一个后台 Kotlin 编译器进程（kotlin-dsl-accessors）来提供符号信息的，不是 VSCode 本地解析。所以改完脚本后，补全卡住、函数变灰，大概率是那个进程没热更新。
比重启编辑器更快的恢复方式：
- 在 VSCode 命令面板（
Ctrl+Shift+P/Cmd+Shift+P）输入并执行：Gradle: Refresh Project - 或者在项目根目录下运行：
./gradlew ktlintFormat（前提是已配置 ktlint）——触发一次 Kotlin 编译，会顺带重建 DSL accessor 缓存 - 避免频繁删
.gradle目录：它会强制重生成全部 accessor，耗时且可能引发Could not resolve plugin artifact错误
真正麻烦的是多模块项目里某个子模块的 build.gradle.kts 引用了未发布的本地插件——这种情况下，补全永远不生效，因为 Gradle 根本没机会编译那个插件的 accessor。
