subl命令失效的根源是subl.exe缺失、path未刷新、shell配置未重载或系统权限拦截；需先确认官方安装含subl.exe，再正确配置path并重启终端，macos/linux需修改对应shell初始化文件，最后检查系统权限。
subl 命令失效？先确认 subl.exe 是否真实存在
Windows 上敲 subl 报“不是内部或外部命令”，90% 的情况不是 PATH 配错了，而是根本没这个文件。官方安装包（.exe）默认会把 subl.exe 放在安装根目录下（如 C:\Program Files\Sublime Text\subl.exe），但绿色版、便携版、第三方打包版几乎都不带它。
- 打开 Sublime 安装目录，手动找一下有没有
subl.exe；没有就别往下配 PATH，重装官网正版 - 安装时勾选 “Add to PATH” 仅对 Windows 10/11 新版安装器有效；旧版或解压安装不会触发该选项
- 若自定义安装路径（如
D:\Tools\Sublime Text），必须把该**完整路径**加入 PATH，不能只加D:\Tools\Sublime Text\subl.exe或子目录
PATH 写对了，cmd 还不认 subl？重启终端是硬性前提
改完环境变量后，旧的 CMD/PowerShell 窗口不会自动加载新 PATH —— 这是 Windows 的行为机制，不是 bug。
- 关掉所有已打开的终端窗口（包括 Windows Terminal、ConEmu 的全部实例，不只是标签页）
- 新开一个终端，再运行
subl --help测试 - 杀毒软件或企业组策略可能静默拦截 PATH 修改，此时即使路径正确，
subl也会无响应或直接拒绝执行
macOS/Linux 下 subl 不生效？别碰 /etc/environment
macOS 和 Linux 没有全局 GUI 级 PATH，图形界面启动的 Sublime 不读系统级配置。只改 /etc/environment 或桌面环境 PATH 是无效的。
- zsh 用户（macOS Catalina+ 默认）：编辑
~/.zshrc，加一行export PATH="/Applications/Sublime Text.app/Contents/SharedSupport/bin:$PATH" - bash 用户：改
~/.bash_profile或~/.bashrc，内容类似 - GNOME/KDE 等桌面环境需执行
source ~/.zshrc或注销重登录，否则 GUI 应用仍看不到新 PATH
项目级环境变量怎么隔离？用 EnvFile 插件加载 .env 文件
Sublime Text 本身不支持 dotenv，但 EnvFile 插件能自动识别 .env、.env.development 等文件，并在 Build System 执行时注入变量。
- 通过 Package Control 安装
EnvFile，安装后无需启用，插件自动生效 - 项目根目录放
.env.development，再设环境为development，插件会优先加载它，再 fallback 到.env - 配合自定义 Build System 使用（如 Python 构建中加
"env": {"PYTHONPATH": "$project_path/src"}），才能真正把变量传给解释器
env 字段和插件加载顺序——EnvFile 只影响 Build 过程，不影响 Sublime 自身进程的环境变量，也不影响你手动在终端里跑的命令。
