subl 命令未安装是主因，需手动创建软链接：APT 安装后执行 sudo ln -sf /opt/sublime_text/sublime_text /usr/local/bin/subl；tarball 安装则链接其 bin/subl 文件；注意路径、引号及显示环境。
subl 命令根本没装，不是 PATH 没配对
输 subl --version 报 command not found，90% 的情况不是环境变量写错了，而是压根没安装命令行工具。Sublime Text 官方安装包（无论 APT 还是 tarball）默认不自动注册 subl 命令——它得你手动启用或链接。
APT 安装后必须手动建软链接到 /usr/local/bin/subl
用 sudo apt install sublime-text 装完，二进制文件实际在 /opt/sublime_text/sublime_text（注意不是 subl），系统不会自动创建命令别名。你需要自己补上这步：
- 确认路径存在：
ls /opt/sublime_text/sublime_text - 建软链接：
sudo ln -sf /opt/sublime_text/sublime_text /usr/local/bin/subl - 新开终端，运行
which subl应输出/usr/local/bin/subl；再跑subl --version能打印版本号才算成功
别链到 ~/Downloads/... 或临时解压目录——删掉那个文件夹，subl 就立刻失效。
tarball 手动安装时，subl 可执行文件就在 bin/ 目录里
如果你下的是官网 .tar.bz2 包，解压后进入目录，会看到 subl 和 sublime_text 两个可执行文件。前者就是专为命令行准备的轻量封装：
- 查位置：
ls -l sublime_text_*/subl - 建链接：
sudo ln -s /path/to/sublime_text_*/subl /usr/local/bin/subl - 注意：不要用
sublime_text替代subl——前者是 GUI 主程序，直接调用可能卡住终端或报--no-sandbox错误
验证通过后，打开文件还得注意空格和中文路径
subl 对路径中的空格、中文非常敏感，Linux 下尤其容易静默失败：
- 路径含空格？必须用单引号：
subl 'my project/file.js' - 路径含中文？同样加引号，且确保终端 locale 支持 UTF-8（
locale | grep UTF-8） - 想后台启动不阻塞终端？加
-background参数，但别滥用——它会让终端无法感知编辑是否完成，影响后续脚本逻辑
最常被忽略的一点：subl 启动的是图形界面进程，如果当前终端没连上 X11/Wayland（比如 SSH 未开启 X 转发），它会直接卡住或报错，而不是友好提示——这时得先确认显示上下文是否就绪。
