gradle构建命令必须用cmd数组而非shell_cmd，$1仅在cmd中生效；linux/macos用./gradlew并赋执行权，windows用gradlew.bat；working_dir须用${project_path:${folder}}；需加--console=plain --no-daemon；android项目需显式设置android_sdk_root环境变量。
Gradle构建命令必须用cmd数组而非shell_cmd
占位符$1只在cmd字段中生效，比如["./gradlew", "$1"]允许你在按Ctrl+B后输入build、test或assembleDebug动态执行；而shell_cmd把整条字符串当 shell 命令执行，不解析变量，写成"shell_cmd": "./gradlew $1"会导致参数被忽略，构建静默失败。
常见错误现象：Ctrl+B后输入clean，输出面板只显示[Finished]，无任何日志。
- Linux/macOS 必须用
./gradlew（注意.和/），且确保文件有执行权：chmod +x gradlew - Windows 必须用
gradlew.bat，不是./gradlew，否则报The system cannot find the file specified - 若项目根目录缺失
gradlew.bat，别手动创建——应从标准 Gradle Wrapper 初始化流程生成
working_dir必须用${project_path:${folder}}
Gradle Wrapper 依赖项目根目录下的gradle/wrapper/gradle-wrapper.properties，一旦working_dir不对，就会报Could not initialize class org.gradle.wrapper.GradleWrapperMain或No such file or directory: gradle/wrapper/gradle-wrapper.jar。
固定路径如"working_dir": "/home/user/myproject"看似可行，但多项目切换或团队协作时极易失效；而${project_path:${folder}}是 Sublime 提供的动态变量：优先取当前打开的 project 路径，project 未定义时退回到第一个打开的文件夹，兼容性最强。
- Android 项目尤其敏感——
settings.gradle或settings.gradle.kts必须能被正确加载，否则 AGP 报错卡在类初始化阶段 - 如果项目含多模块（如
:app、:lib），working_dir指向根目录才能保证./gradlew :app:build这类带前缀的任务正常识别
file_regex要匹配--console=plain输出格式
默认 Gradle 输出含 ANSI 颜色码和嵌套缩进，file_regex无法提取行号和文件路径，导致双击错误行无法跳转。必须强制使用--console=plain --no-daemon压制干扰，并配对正则。
推荐写法："cmd": ["./gradlew", "--console=plain", "--no-daemon", "$1"] + "file_regex": "^(.*?):([0-9]+):([0-9]+):\s*(error|warning):\s*(.*)$"。这个正则能捕获src/main/java/MyClass.java:23:5: error: cannot find symbol这类典型格式。
- 不加
--no-daemon可能导致构建卡在Starting daemon...，Sublime 等待超时后直接标记为[Finished] - Android 项目若用 AGP 8.5+，错误可能带
Caused by:堆栈，但首行仍符合上述正则，足够定位主因 - 避免用过于宽泛的正则如
^([^:]+):([0-9]+)，它会把日志里的 URL 或版本号也误判为可跳转位置
Android 项目需显式注入ANDROID_SDK_ROOT环境变量
Sublime 不继承系统 shell 的环境变量，即使echo $ANDROID_SDK_ROOT在终端返回有效路径，构建进程里仍是空值，导致Failed to find Build Tools revision 34.0.0或SDK location not found。
解决方案是在构建系统 JSON 中添加"env"字段："env": {"ANDROID_SDK_ROOT": "/Users/you/Library/Android/sdk"}（macOS）或"env": {"ANDROID_SDK_ROOT": "C:\Users\you\AppData\Local\Android\Sdk"}（Windows）。
- 路径必须真实存在且包含
platform-tools/、build-tools/等子目录 - 不要用
$HOME或%USERPROFILE%变量——Sublime 构建进程不展开它们 - 若同时开发多个 Android 版本，建议在
variants里为不同任务设不同env，例如Clean任务可不设，AssembleDebug任务才设
真正麻烦的从来不是写几行 JSON，而是某次重构后settings.gradle挪了位置、gradle-wrapper.properties升级了版本、或者 SDK 路径被 IDE 自动重置——这些细微变动都会让原本好用的构建系统突然失灵，而错误信息往往藏在几百行日志中间某一行不起眼的位置。
