sublime text需手动创建gradle构建系统（.sublime-build）文件，通过配置cmd、working_dir等字段调用gradlew执行任务；推荐使用gradlew而非全局gradle以确保版本一致，并注意sdk路径、编码、jvm参数等常见问题。
Sublime Text 本身不内置 Gradle 构建支持，但可以通过自定义 build_system 实现一键执行 gradlew 或系统级 gradle 命令——关键不是“装个插件就自动构建”，而是让 Sublime 知道该调什么命令、在哪调、怎么传参。
如何创建 Gradle 构建系统（.sublime-build）
Sublime 的构建功能依赖 JSON 格式的构建定义文件，需手动创建并放在正确路径下。它不识别 build.gradle 内容，只负责调用外部命令。
- 在 Sublime 中打开菜单 Tools → Build System → New Build System…
- 替换默认内容为以下配置（适配 Linux/macOS）：
{
"cmd": ["./gradlew", "$1"],
"working_dir": "${project_path:${folder}}",
"selector": "source.java, source.groovy",
"shell": true,
"variants": [
{
"name": "Clean",
"cmd": ["./gradlew", "clean"]
},
{
"name": "AssembleDebug",
"cmd": ["./gradlew", "assembleDebug"]
}
]
}
- Windows 用户把
"./gradlew"换成"gradlew.bat"，并确保gradlew.bat在项目根目录存在 - 保存为
Gradle.sublime-build，默认位置是~/Library/Application Support/Sublime Text/Packages/User/（macOS）或%APPDATA%\Sublime Text\Packages\User\（Windows） -
"selector"控制快捷键Ctrl+B是否激活该构建系统：只有当前文件是 Java/Groovy 时才可用
为什么推荐用 gradlew 而不是全局 gradle
直接调用 gradle 命令容易失败，因为项目可能依赖特定版本的 Gradle，而你本地装的版本和项目 gradle/wrapper/gradle-wrapper.properties 里声明的不一致。
-
gradlew是项目自带的 wrapper 脚本，会自动下载并使用distributionUrl指定的 Gradle 版本 - 若项目没提交
gradlew，说明它可能依赖全局环境变量，此时需确认gradle -v输出版本是否匹配buildscript.classpath 'com.android.tools.build:gradle:x.x.x'所需的 Gradle 版本（查对应关系见 Android Gradle Plugin 版本映射表） - 如果
./gradlew tasks在终端能跑通，但在 Sublime 构建里报command not found，大概率是shell环境没加载你的~/.zshrc或~/.bash_profile——加"shell": true通常能解决，否则得显式指定完整路径如/usr/local/bin/gradle
常见错误：找不到 SDK 或 NDK
执行 assembleDebug 时报错类似 Could not find method android() for arguments 或 SDK location not found，这不是 Sublime 的问题，而是 Gradle 配置缺失。
- 检查项目根目录是否存在
local.properties；若无，手动创建，内容为：
sdk.dir=/Users/you/Library/Android/sdk ndk.dir=/Users/you/Library/Android/sdk/ndk-bundle
- 路径必须是绝对路径，Windows 下用反斜杠或正斜杠均可，但不能用环境变量如
%LOCALAPPDATA% - 如果项目用了旧式 Ant 结构（
project.properties），Sublime 构建会失败——Gradle 构建系统只认新结构（含settings.gradle和模块级build.gradle） - 报
Could not find com.android.tools.build:gradle:x.x.x？说明buildscript.repositories里没配对的仓库，或者 jcenter() 已停用（2021 年后），应改用mavenCentral()
构建输出中文乱码或卡死怎么办
Sublime 默认用系统 locale 解析构建输出，Java/Gradle 日志含中文时容易崩或显示为 。
- 在
.sublime-build文件中添加"encoding": "UTF-8"（仅对部分平台有效） - 更可靠的做法：在
"cmd"中强制指定编码，例如 macOS/Linux：
"cmd": ["sh", "-c", "export JAVA_TOOL_OPTIONS='-Dfile.encoding=UTF-8' && ./gradlew $1"]
- 如果构建过程卡在
:app:compileDebugJavaWithJavac不动，大概率是 JVM 内存不足，可在gradle.properties加：
org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m
- Sublime 构建窗口不支持交互式输入（比如签名密码），所有需要交互的 task（如
signingConfig）必须提前在gradle.properties里配置好storePassword等字段
真正难的不是写那个 .sublime-build 文件，而是搞清项目用的是哪版 Gradle、插件是否兼容、SDK 路径有没有被 Git 忽略、以及输出日志里那行真实错误到底在抱怨什么——Sublime 只是管道，背后全是 Gradle 的规则。
