sublime text 无法实现分布式微服务多工程统一编译，必须依赖 gradle 命令行驱动；其 lsp 插件不支持跨模块语义索引，需手动启动 languageserver 并正确配置工作目录与参数，build system 也须显式指定根项目路径和环境属性。
Sublime Text 本身不支持分布式微服务多工程的统一编译——它没有项目级依赖解析能力，也不维护 Gradle 守护进程、不跟踪 settings.gradle.kts 中的 include(":api", ":consumer", ":provider") 结构，更不会跨模块推导 compileClasspath 或触发 buildDependents。所谓“统一编译”，必须交由 Gradle 命令行驱动，Sublime 只能作为快捷入口。
Gradle-LSP 在 Sublime 中无法实现跨模块语义索引
gradle-lsp（如 gradle-language-server）依赖后台 Gradle 守护进程提供模型数据，但 Sublime 的 LSP 插件默认只对当前打开的单个 .gradle.kts 或 .kt 文件做轻量解析，不主动加载整个 settings.gradle.kts 所声明的多模块拓扑。
- 现象：跳转
actual实现失败、import提示缺失、@JvmStatic标记无响应 - 原因：LSP 启动时未指定
--project-dir，或未在根目录下运行./gradlew --no-daemon -Dorg.gradle.daemon=false languageServer - 解决路径：手动在项目根目录终端执行
./gradlew languageServer，再配置 LSP 插件指向该进程的stdio端口；但每次模块增删后需重启 LSP - 注意：
languageServer任务需在根项目的build.gradle.kts中显式启用插件：plugins { id("com.gradle.enterprise").version("3.14.1") }（否则 Gradle 5.6+ 默认不暴露该任务）
Sublime Build System 调用 ./gradlew 编译多模块必须指定 root project
直接在某个子模块目录下按 Ctrl+B 触发 Build，若 Build System 没有显式切换工作目录，./gradlew 会报错 Could not read script '/path/to/consumer/gradle/wrapper/gradle-wrapper.properties' 或 Task 'build' not found。
- 正确写法（放在
Preferences → Package Settings → Build Systems → User）： -
"working_dir": "${project_path:${folder}}"—— 强制回到项目根目录，而非当前文件所在子模块路径 -
"cmd": ["./gradlew", "-p", ".", "build"]——-p .明确指定 root project，避免 Gradle 自动向上查找时误入父级无关仓库 - 不要用
"cmd": ["./gradlew", "build"]+"working_dir": "$file_path"，这会导致仅编译当前模块，且可能因缺少api模块依赖而失败 - 若需编译特定组合（如只构建
consumer和其 runtime 依赖），用./gradlew consumer:build --include-build ../api，但--include-build路径必须是相对路径，不能是../api之外的绝对路径
多工程环境下 Gradle 属性与 profile 切换容易失效
微服务项目常通过 -Penv=pro 控制不同环境的资源加载，但在 Sublime 的 Build System 中硬编码 "cmd": ["./gradlew", "-Penv=pro", "build"] 会导致无法快速切换 dev/test/pro。
- 推荐做法：改用
Terminus插件绑定多个预设命令，例如： -
"name": "Build Dev Services"→["./gradlew", "-Penv=dev", "consumer:build", "provider:build"] -
"name": "Build Prod API Only"→["./gradlew", "-Penv=pro", "api:build"] - 关键点：
sourceSets中的resources.srcDirs必须匹配-Penv值，例如src/main/profile/${env}；若env为空，则 fallback 目录（如src/main/resources）必须存在，否则编译报Resource missing - 陷阱：Gradle 属性在
initialization阶段读取，但sourceSets配置在configuration阶段执行；若在buildSrc中提前读取project.findProperty("env")并用于 classpath 构建，可能因阶段错位导致空值
./gradlew 命令本身，而不是编辑器里任何“智能集成”。Sublime 的价值在于快捷唤起正确上下文的终端，而不是替代 Gradle 的生命周期管理。多工程统一编译的复杂性，最终落在 settings.gradle.kts 的模块组织、dependencyConstraints 的版本对齐、以及 buildScan 报告中 task execution order 的可预测性上——这些，Sublime 看不见，也管不了。
