最直接验证方式是新开终端执行 subl --help：若输出帮助信息则配置成功，否则失败；需确认 subl 文件存在、PATH 路径正确、shell 配置已重载（如 source ~/.zshrc）、Windows 需重启终端。

终端执行 subl --help 是否成功

这是最直接的验证方式。打开一个全新终端（不是已打开的旧窗口），输入：

subl --help

如果输出帮助信息，说明 subl 命令已被系统识别，PATH 配置已生效；若提示 command not found 或 'subl' 不是内部或外部命令，则尚未配置成功。

检查 subl 可执行文件是否真实存在

很多情况下不是 PATH 没配对，而是根本没这个文件。

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

• Windows：去 Sublime 安装目录（如 C:\Program Files\Sublime Text）手动找 subl.exe；找不到就别折腾 PATH，重装官网正版安装包
• macOS：检查 /Applications/Sublime Text.app/Contents/SharedSupport/bin/subl 是否存在；路径含空格（如 Sublime Text 4）时，要用引号包裹整个路径
• Linux（tarball 版）：确认解压后目录下是否有 sublime_text，且你加进 PATH 的是该目录本身，不是子目录

确认 shell 初始化文件是否重载

macOS/Linux 用户常忽略这点：PATH 修改写在 ~/.zshrc 或 ~/.bash_profile 后，必须显式重载才生效。

• 改完文件后，运行 source ~/.zshrc（或对应文件）
• 然后在**同一终端**里再试 subl --help
• 如果仍失败，检查是否误写成 ~/.zprofile 却用了 zsh —— zsh 默认不读 ~/.zprofile，除非你显式配置了

Windows 上 PATH 修改后必须重启终端

改完系统环境变量后，所有已打开的 CMD、PowerShell、Windows Terminal 进程都不会自动更新 PATH，这是 Windows 行为，不是 bug。

• 关闭所有终端窗口
• 重新打开一个，再执行 subl --help
• 若仍不行，用 where subl 查找系统是否在多个位置注册了冲突的 subl.bat 或旧版本残留

真正卡住的地方往往不在配置逻辑，而在于「你以为 reload 了，其实没 reload」——比如改了 ~/.zshrc 却没 source，或者 Windows 改完 PATH 却还在用旧的 PowerShell 窗口。验证前，先确保终端是“干净新启”的。