Sublime Build系统不继承shell配置导致环境变量不可用，需通过终端启动（macOS）、修改系统Path（Windows）或硬编码路径解决；Java/Python/C++构建应指定绝对路径，.env变量需EnvFile插件支持，中文乱码和类加载失败需检查编码、-d参数及working_dir设置。
Sublime 里 build 系统读不到环境变量？先确认它根本没继承 shell 配置
Sublime 启动时只继承系统级环境变量，不加载 ~/.zshrc、~/.bash_profile 或 Windows 用户变量里的 PATH 修改。macOS 图形界面双击打开、Windows 从开始菜单启动，都属于“不读 shell 配置”的典型场景。终端里 which python 能出结果，Sublime 里 Ctrl+B 却报 command not found，大概率卡在这一步。
验证方式：按 Ctrl+` 打开 Sublime 控制台，输入：
import os; print(os.environ.get('PATH'))搜你期望的路径（比如 /opt/homebrew/bin 或 %JAVA_HOME%\bin），没有就说明没继承。
- macOS 推荐用终端启动：
open -a "Sublime Text"或先配好subl命令再用subl . - Windows 必须改“系统变量”里的 Path，不能只改用户变量；改完后右键任务栏图标 → “退出”，不是关窗口
- Linux 可用
pkill subl杀干净进程再重开
Java/Python/C++ 一键运行总失败？别依赖 PATH，直接硬编码可执行文件路径
靠环境变量不可靠，尤其多 JDK、多 Python 版本或便携版 MinGW 时。shell_cmd 或 cmd 字段里写死绝对路径，是最稳的做法。
例如 Java 构建文件中这样写才不踩坑：
"shell_cmd": "/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home/bin/javac -encoding UTF-8 \"$file\" && /Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home/bin/java \"$file_base_name\""
- Windows 下路径用正斜杠或双反斜杠：
C:/Program Files/Java/jdk-17.0.1/bin/javac - Python 若用 conda 环境，路径可能是
/Users/xxx/miniconda3/envs/myenv/bin/python - C++ 若用 MinGW-w64，别用
g++.exe的快捷方式，找真实g++.exe文件路径
想按项目加载 .env？EnvFile 插件 + 自定义 build system 是最小可行方案
Sublime 原生不解析 .env 文件。要让构建命令读取项目级环境变量，得靠 EnvFile 插件配合显式注入。
安装后，在项目根目录放 .env（如 API_KEY=abc123），再新建一个 PythonWithEnv.sublime-build：
{
"shell_cmd": "python \"$file\"",
"env": {
"PYTHONPATH": "$project_path",
"API_KEY": "$ENV_API_KEY"
}
}
-
EnvFile插件会自动把.env里的变量挂到$ENV_XXX下，供 build 文件引用 - 不支持嵌套变量展开（如
BASE_DIR=/app+LOG_PATH=$BASE_DIR/logs不生效） - 若需多环境（dev/staging/prod），插件支持
.env.development优先级高于.env
中文乱码、NoClassDefFoundError、找不到 main class？这些都不是 build 文件写得不够 fancy
真正卡住人的，往往是三个硬性条件没对齐：
- 源码有
package com.example;→ 构建必须带-d .，且working_dir设为包结构的父目录（如src） - 中文字符编译报错 →
javac必加-encoding UTF-8，java加-Dfile.encoding=UTF-8 - 运行时报
Could not find or load main class→ 检查java命令后跟的是全限定类名（com.example.Main），不是$file_base_name
这些细节一旦漏掉一个，build 文件写得再漂亮也没用。尤其是 -d . 和 working_dir 的组合，是 Java 项目最常被忽略的耦合点。
