subl命令找不到，先确认subl.exe（windows）或symlink（macos/linux）是否存在；path配置后须重启终端，且macos/linux需修改shell初始化文件如~/.zshrc，再source生效。
subl 命令找不到？先确认 subl.exe 或 symlink 是否真实存在
Windows 上 subl 命令无效，90% 的情况不是 PATH 配错了，而是根本没这个可执行文件。官方安装包（.exe）默认会把 subl.exe 放在安装目录根路径下（如 C:\Program Files\Sublime Text\subl.exe），但绿色版、解压即用版、第三方打包版通常不带它。
验证方法：手动打开 Sublime 安装目录，看有没有 subl.exe；macOS/Linux 则检查是否已创建 symlink：
ls -l /usr/local/bin/subl
没有就别折腾 PATH，重装官网正版或手动建 symlink。
PATH 写对了却 still not recognized？必须重启终端进程
改完系统 PATH 后，旧的 CMD/PowerShell/Terminal 窗口不会自动 reload 新变量——这是操作系统行为，不是 Sublime 的问题。
- 关掉所有已打开的终端窗口（不只是标签页）
- 重新打开一个干净的终端，再运行
subl --help - Windows Terminal、ConEmu、WSL 等也得整个程序重启，不能只新开 tab
- 杀毒软件或企业组策略可能拦截 PATH 注册，此时即使路径正确也会静默失败
macOS/Linux 下 subl 不生效？别只改 GUI PATH，要动 shell 初始化文件
图形界面（如 Finder、Dock 启动的 App）和终端启动的命令走的是两套 PATH 机制。只改 /etc/environment 或系统设置里的“环境变量”对 subl 命令无效。
必须把路径写进当前 shell 的初始化文件：
- zsh（macOS Catalina+ 默认）：编辑
~/.zshrc，加一行export PATH="/Applications/Sublime Text.app/Contents/SharedSupport/bin:$PATH" - bash：改
~/.bash_profile或~/.bashrc - 改完后运行
source ~/.zshrc，或直接新开终端 - GNOME/KDE 桌面环境下，GUI 应用可能需注销重登录才识别新 PATH
subl . 打不开当前目录？权限和沙盒才是真瓶颈
subl . 报 “Permission denied” 或无响应，大概率不是 PATH 或配置问题，而是系统级限制：
- macOS Sonoma+ 启用完全磁盘访问（Full Disk Access）后，
subl若未被授权，连当前目录都打不开 - Windows 10/11 的 Controlled Folder Access 或第三方安全软件会拦截
subl.exe对文件系统的调用 - 某些 Linux 发行版（如 Fedora Silverblue）使用 OSTree，
sublsymlink 可能指向只读路径
这类问题无法靠改 PATH 或重装解决，得去系统隐私设置里给 Sublime Text 授予对应权限。
