Sublime环境变量问题根源在于图形界面启动时不继承shell配置，需手动透传PATH、硬编码工具路径、用EnvFile插件注入.env变量，并为Java/Python显式指定UTF-8编码。
subl 命令无效、Ctrl+B 报 javac: command not found、Python 脚本中文乱码或找不到模块——这些问题根本不是 Sublime 本身的问题，而是环境变量没透传或没写对。直接改配置文件不如先搞清它在哪读 PATH、怎么加载、哪些路径必须硬编码。
subl 命令为啥在终端能用，双击图标就失效？
macOS/Linux 图形界面启动 Sublime 不读 ~/.zshrc 或 ~/.bash_profile，Windows 双击也不继承你刚改完的系统 PATH。它启动时用的是登录会话的“快照”，不是实时环境。
- macOS 推荐用终端启动：
open -a "Sublime Text"或subl . - Linux 桌面环境下，改完
~/.profile或~/.zshrc后需注销重登录，仅source不够 - Windows 必须右键任务栏图标 → “退出”，再重新双击打开；只关窗口不杀进程，旧 PATH 仍生效
Build System 里该不该写绝对路径？
该。尤其当你有多个 JDK/Python 版本、或依赖 pip install 的包（如 requests）时，PATH 不稳定，shell_cmd 里用 python 或 javac 很容易指向错版本或根本找不到。
- Java 编译：用
"shell_cmd": "/usr/lib/jvm/jdk-17.0.1/bin/javac -encoding UTF-8 \"$file\""，别信自动继承 - Python 运行：写成
"cmd": ["/opt/homebrew/bin/python3", "-u", "$file"]，避免和系统/usr/bin/python3混淆 - 带 virtualenv 的项目：直接用
"/path/to/venv/bin/python"，比激活环境再调用更可靠
.env 文件里的变量为什么 Build 不生效？
Sublime 原生不读 .env，必须靠插件注入。EnvFile 插件只在 Build System 执行时把变量塞进子进程环境，但不会改 Sublime 主进程的环境变量——所以你在控制台里 print(os.environ) 看不到。
- 确认已通过 Package Control 安装
EnvFile，且项目根目录存在.env或.env.development - Build System 中需显式启用插件：加一行
"env": {"USE_ENVFILE": "1"}（部分旧版需要） - 变量名不能含点号或连字符，
API_URL可以，api.url或api-url会被 EnvFile 忽略
中文源码编译失败，到底该改哪？
错误提示常是 非法字符 或 SyntaxError: Non-UTF-8 code starting with，根源不在文件编码本身，而在编译器没被告知用 UTF-8 解析源码。
- Java 必加
-encoding UTF-8参数，否则默认用系统 locale（Windows 是 GBK） - Python 文件开头加
# -*- coding: utf-8 -*-仅对 Python 解释器有效，对 Sublime 的 Build System 无影响 - Windows 下还建议给
java命令加-Dfile.encoding=UTF-8，否则System.out.println("你好")可能乱码
真正卡住人的从来不是“怎么配”，而是不知道 Sublime 在哪个环节丢了环境变量——它不继承图形界面的 PATH，不自动 reload shell 配置，也不解析项目根目录的 .env，除非你明确告诉它该怎么做。
