subl 命令在终端不可用，说明安装时没注册系统路径或软链接缺失——这不是“装完了”，而是安装流程卡在了最后一环。
Windows 上 subl 命令为何无效？
安装向导里勾选了「Add to PATH」，但实际仍无法在 PowerShell 或 CMD 中执行 subl，常见原因有三个：
- 安装过程未以管理员身份运行，导致写入
C:\Program Files\Sublime Text下的注册表或环境变量失败； - PATH 更新未生效：安装后没重启终端，或没重新加载用户环境（可执行
refreshenv或重启 shell）； - 某些 Windows 版本（如 22H2+）启用“应用执行别名”后，会优先调用 Microsoft Store 的假
subl，需在「设置 → 应用 → 高级应用设置 → 应用执行别名」中关闭它。
验证方式：打开新终端，运行 where subl。若无输出，说明 PATH 未生效；若有输出但指向错误路径（比如 C:\Users\XXX\AppData\Local\Microsoft\WindowsApps\subl.exe），就是被别名劫持了。
Linux 下手动安装后 subl 打不开 GUI 界面
用 tar -xvf 解压官方 .tar.bz2 包并创建 /usr/bin/subl 软链接后，终端输入 subl 报错 Failed to load session: Unable to connect to D-Bus 或直接静默退出，本质是 GUI 启动上下文缺失：
- 必须通过桌面环境启动（如点击图标），或在终端中使用
dbus-run-session subl； - 若想全局可用，建议改用 APT 安装：
sudo apt install sublime-text，它自带 systemd user session 集成和 D-Bus 配置； - 手动安装时，
/usr/bin/subl软链接目标应为/opt/sublime_text/sublime_text，而非带参数的 shell wrapper——加参数易破坏 IDE 协议通信。
macOS 安装后命令行调用报错 Sublime Text cannot be opened because the developer cannot be verified
这是 macOS Gatekeeper 的硬性拦截，不是权限问题，也不是证书过期——Sublime Text 官方分发的 .dmg 和 Homebrew 安装版本都受此限制：
- 临时绕过：右键
Sublime Text.app→「打开」→ 弹窗点「仍要打开」，仅需一次； - 永久放行：终端执行
xattr -rd com.apple.quarantine /Applications/Sublime\ Text.app； - Homebrew 用户注意：
brew install --cask sublime-text安装后仍需手动放行，因为 Apple 不信任 brew cask 的签名链； - 别用「访达 → 显示简介 → 解锁 → 勾选任何来源」——该选项在 macOS Sonoma 及之后已被移除。
Package Control 安装失败或插件列表空白
按下 Ctrl+` 粘贴 Python 安装脚本后无反应，或 Ctrl+Shift+P 输入 Install Package 提示「No packages available」，核心原因是网络策略或本地缓存污染：
- 国内用户默认走
http://packagecontrol.io，该域名已长期被干扰，必须手动切换源：在Preferences → Package Settings → Package Control → Settings – User中添加："channels": ["https://packagecontrol.io/channel_v3.json"]； - 如果之前装过非官方汉化包（尤其是修改过
Default/Preferences.sublime-settings的），会导致 Package Control 初始化失败，需删除~/.config/sublime-text-4/Installed Packages/Package Control.sublime-package并重启； - 首次安装成功后，左下角会出现「Package Control: Installed」提示，且
Preferences → Package Control菜单项可见——这是唯一可靠的成功信号，不要只看控制台有没有报错。
subl 不工作、中文不显示、插件装不上——这些都不是软件缺陷，是安装动作和系统底层契约没对齐。每个操作系统对 GUI 应用、PATH 注册、签名验证、D-Bus 会话的约定完全不同，跳过校验步骤，后面所有功能都会断层。
