Windows安装Sublime Text时必须勾选Add to PATH和Add to explorer context menu，二者为硬依赖，缺一将导致subl命令不可用、右键无打开选项；路径须避免中文或空格，否则插件加载失败；macOS需解除Gatekeeper拦截，Linux应走官方APT源安装。
subl 命令不可用、右键菜单没选项、插件装不上、中文不显示——这些问题 90% 都出在安装环节，不是配置或插件的问题。
Windows 安装必须勾选的两个选项
Add to PATH 和 Add to explorer context menu 不是“建议”，是硬性依赖。跳过任何一个，后续所有自动化流程都会卡住。
-
Add to PATH不勾：终端里敲subl .报错'subl' is not recognized，Git 提交时设core.editor失效，CLI 工具链全断 -
Add to explorer context menu不勾：右键任何文件都看不到 “Open with Sublime Text”，批量处理日志、配置、代码文件时效率腰斩 - 安装路径别改：默认
C:\Program Files\Sublime Text最稳妥；改成D:\我的工具\Sublime Text或含空格路径，会导致Package Control的urllib请求解析失败，插件静默加载失败
macOS 启动报“已损坏”怎么解
这不是病毒警告，是 Gatekeeper 对未公证二进制的拦截。别点“取消”，也别用第三方“破解工具”。- 正确操作：首次启动失败后，右键 Dock 图标 → “显示简介” → 勾选“仍要打开”（Sonoma 及更新系统需先点锁图标解锁）
- 勾完再从终端运行
subl --project，否则 Shell 与 GUI 进程通信不通，自定义 Build System 里的 shell 调用会静默失败 - 别手动删
com.apple.quarantine属性：xattr -d com.apple.quarantine会破坏 AppleScript 集成，后续 Alfred/Keyboard Maestro 触发编辑器找不到进程
Linux 该用 apt 还是 tarball
Ubuntu/Debian 用户必须走官方 APT 源，禁用apt install sublime-text（那是旧版阉割包），更别手动解压 + alias。
- 正确流程：先导入密钥
wget -qO - <a href="https://www.php.cn/link/ce08d2c316a39561ddfeb8a8ba9cbd1f">https://www.php.cn/link/ce08d2c316a39561ddfeb8a8ba9cbd1f</a> | sudo tee /etc/apt/trusted.gpg.d/sublimehq.asc > /dev/null，再添加源deb <a href="https://www.php.cn/link/01ad78c33cf1fcaf447971fa919a96b7">https://www.php.cn/link/01ad78c33cf1fcaf447971fa919a96b7</a> apt/stable/，最后sudo apt update && sudo apt install sublime-text - 手动解压 +
sudo ln -s /opt/sublime_text/sublime_text /usr/bin/subl看似可行，但 D-Bus session bus 无法识别多实例，SideBarEnhancements实时刷新、文件监听全部失效 - 安装后验证：终端直接输
subl能唤起 GUI，且应用菜单出现图标，才算真正打通
Package Control 装不上？先看这三件事
控制台粘贴脚本没反应、报urllib.error.URLError 或 AttributeError: module 'sublime' has no attribute 'installed_packages_path'，基本是版本或网络问题。
- ST4 用户必须用 packagecontrol.io 的最新脚本，旧脚本（比如来自
sublime.wbond.net）在 ST4 下静默失败，无提示也不报错 - 国内用户常因 DNS 污染导致
<a href="https://www.php.cn/link/061573ca4ba2b0e068e0614d6d17ac3e">https://www.php.cn/link/061573ca4ba2b0e068e0614d6d17ac3e</a>解析失败 → 改用 HTTPS 地址，或手动下载Package Control.sublime-package放入~/Library/Application Support/Sublime Text/Installed Packages/（macOS）或对应路径后重启 - 杀毒软件或防火墙可能拦截 Python 网络请求 → 临时关闭，或把
sublime_text.exe加入信任列表
真正干净的安装，从来不是“点下一步就完事”。路径、权限、初始化三者只要一个不洁，subl 就只是个摆设，插件再炫也没法加载。
