必须勾选add to explorer context menu、add to path、create a desktop shortcut三项，否则右键打开、命令行调用subl、快速启动全部失效，且路径含中文或空格会导致构建系统静默失败。
Windows 安装时必须勾选的三项配置
跳过这三项，后续几乎所有自动化操作都会失效。不是“可选”，是硬依赖。
-
Add to explorer context menu：不勾，右键任意文件看不到“Open with Sublime Text”，连快速打开都得先启动编辑器再拖文件进去 -
Add to PATH：不勾，终端输subl会报'subl' is not recognized，Git commit message、脚本调用、IDE 联动全断链 -
Create a desktop shortcut：新手找图标容易卡住，尤其当开始菜单被 Win11 改得面目全非时，桌面图标是最直接的 fallback
路径别改到带中文或空格的目录（比如 C:\Program Files (x86)\Sublime Text 或 D:\我的软件\Sublime Text），否则后续 Build System 里调用 g++ 或 python 时，shell 会因路径解析失败直接静默退出，连错误都不报。
Package Control 安装失败的两种典型卡点
Ctrl+` 打开控制台，粘贴官方脚本后没反应，或提示 SSL: CERTIFICATE_VERIFY_FAILED，基本就这两类原因。
- 网络干扰：国内访问
packagecontrol.io不稳定，换手机热点最有效；若必须走公司代理，需在脚本里显式加ProxyHandler，但不如直接切网络 - 脚本版本错：ST4 必须用含
hashlib.sha256校验逻辑的脚本，老版（只用urllib的）即使显示 “Success!”，后续也加载不出插件列表——它根本没连上服务器
安全兜底做法：去 https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445 下载 Package Control.sublime-package 文件，手动丢进 %APPDATA%\Sublime Text 4\Installed Packages，重启即生效。
Linux 下 APT 安装与手动解压的本质区别
APT 方式（sudo apt install sublime-text）和手动解压 .tar.bz2 看似都能跑起来，但底层权限模型和更新机制完全不同。
- APT 安装走的是系统包管理器，二进制放在
/opt/sublime_text/，自动注册subl命令，且能通过sudo apt update && sudo apt upgrade一键升级——这是长期支持的关键 - 手动解压方式，哪怕你建了
/usr/bin/subl软链接，插件签名验证也会失败，因为官方.sublime-package文件含 RSA 签名，而手动部署绕过了 APT 的密钥链校验流程 - 如果必须离线安装，解压后务必运行
sudo ./sublime_text --install-cmd（路径按实际调整），否则subl命令无法全局生效
ChineseLocalization 插件不生效的隐藏开关
装完插件、切了简体中文，界面还是英文？大概率是 ignored_packages 在后台悄悄屏蔽了它。
- 打开
Preferences → Settings，检查右侧用户设置里是否有"ignored_packages": ["ChineseLocalization"]这行——常见于旧版汉化包残留或误操作 - 注意大小写：
ChineseLocalization不能写成chineselocalization或Chinese-localization，否则插件加载器直接跳过 - 装完插件后必须重启 Sublime Text，仅重载插件（Ctrl+Shift+P →
Package Control: Satisfy Dependencies）不足以触发语言切换
真正长期可用的配置，不在“装得多”，而在每一步是否干净、可验证、可回滚。比如每次升级 ST4 后，第一件事不是装新插件，而是确认 Package Control 能否正常拉取列表——它才是整个生态的健康探针。
