subl命令需先安装命令行工具：macOS通过菜单安装，Linux手动软链，Windows安装时勾选Add to PATH；SSH/WSL等环境需注意GUI会话和PATH配置；控制台为Python解释器，非Shell终端。
subl 命令根本不存在，得先装
你输 subl 报 command not found，不是 PATH 没配对，是压根没装这个工具。Sublime Text 安装包默认不带命令行支持。
- macOS：菜单栏
Sublime Text → Install Command Line Tool，执行完/usr/local/bin/subl就有了（比手动建软链接更稳，自动处理路径空格和更新） - Linux：官方 tarball 版自带
subl可执行文件，但需手动软链，比如sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl；Snap/Flatpak 版本默认不提供 - Windows：安装时勾选
Add to PATH最省事；漏选了就手动把C:\Program Files\Sublime Text\加进系统环境变量，或在C:\Windows\System32下建个subl.bat（内容：@start "" "C:\Program Files\Sublime Text\sublime_text.exe" %*）
验证方式：终端跑 which subl（macOS/Linux）或 where subl（Windows），有输出才算成功；再试 subl --version 看版本号。
subl 打不开文件？大概率是 GUI 上下文错了
能跑 subl --help ≠ 能正常打开文件。很多“卡住”“弹空窗口”“没反应”，本质是 Sublime 启动时拿不到有效的桌面会话。
- SSH 连上去直接跑
subl .？失败概率极高——它需要 DISPLAY 或 Wayland 协议，而 SSH 默认不转发。加-n强制新开窗口：subl -n . - macOS 上用 Terminal 通过 ssh 登录后启动，
subl会静默失败；改用open -a "Sublime Text"或从 Dock 启动终端再试 - WSL 用户注意：
subl不会自动继承 Windows 的 PATH，得在~/.zshrc里显式加：export PATH="/mnt/c/Users/xxx/AppData/Local/Sublime Text/Build 4143/:$PATH" - Git 提交时用
git commit触发编辑器？必须加-w（即--wait），否则 Git 会立刻继续执行，导致提交信息丢失
Console 控制台不是终端，别输 shell 命令
Ctrl + `（macOS 是 Cmd + `）打开的是嵌入式 Python 解释器，不是 bash/zsh，也不是浏览器 DevTools。输 ls 或 pwd 会直接报 NameError，这不是 bug，是设计如此。
- 它能调用全部公开 Sublime API：
sublime.active_window().active_view().file_name()查当前文件，sublime_plugin.reload_plugin("Git")重载插件，sublime.run_command("refresh_folder_list")刷新侧边栏 - 插件里的
print()默认不输出——必须先去菜单Tools → Developer → Log Console Messages勾选启用，否则日志全被屏蔽 -
print()不自动换行，多条日志会挤成一行；建议写成print("debug:", x, "\n") - 看到顶部刷出红色
ImportError或AttributeErrortraceback？那是插件加载失败的第一手证据，含精确路径和行号，比构建输出靠谱得多
控制台里调 API 和命令面板是两套逻辑
很多人输 Set Syntax: JSON 没反应，是因为命令面板（Ctrl + Shift + P）里搜到的字符串，不能直接扔进控制台。控制台只认 Python 语法。
- 命令面板是用户动作入口，只触发已注册命令；控制台是开发者调试入口，直连 Sublime Python 环境
- 想临时切语法？输
view.settings().set("syntax", "Packages/JavaScript/JavaScript.sublime-syntax")，不是字符串，是 Python 表达式 - 想查当前语法类型？输
view.settings().get("syntax")，返回的是完整路径字符串，不是“JSON”这种简写 - 某插件命令搜不到、点不动？控制台可绕过命令面板失效场景，直接调 API 验证是否加载成功，比如
sublime_plugin.plugins()看列表里有没有它
最常被忽略的一点：控制台关闭后所有日志清空，不保存也不归档；真要留痕，得靠外部日志工具或自己写文件输出——别指望它当长期调试记录用。
