Sublime Text“快速安装”需严格完成三步：Windows勾选Add to PATH和Associate with files，macOS右键Dock图标启用“仍要打开”，Linux使用官方APT源；任一缺失将导致subl命令、右键菜单、Package Control等功能失效。
Sublime Text 能不能“快速安装”，取决于你是否跳过三个关键动作：Add to PATH（Windows）、仍要打开（macOS）、用官方 APT 源（Linux）。跳过任一环节，后续 subl .、右键菜单、Package Control 都会出问题，所谓“快速”反而变拖沓。
Windows 下不勾选这两项，等于没装
安装时必须勾选：Add to PATH 和 Associate with files。前者决定你能否在 CMD/PowerShell 里敲 subl . 打开当前目录；后者决定右键菜单有没有“Open with Sublime Text”。没勾前者，subl --command 报错 'subl' is not recognized；没勾后者，双击 .py 或 .json 文件不会唤起 Sublime，只能手动拖拽——批量处理配置或日志时效率直接腰斩。
安装路径建议保留默认（C:\Program Files\Sublime Text），避免中文路径或空格，否则 Python 插件（如 Package Control）的 urllib 请求可能因路径解析失败而静默退出。
macOS 上点“取消”就卡死在 Gatekeeper
首次启动弹出“已损坏，无法打开”，这不是病毒警告，是 Gatekeeper 对未签名二进制的拦截。正确操作是：右键 Dock 中图标 → “显示简介” → 勾选 仍要打开（Sonoma 及更新系统需先点锁图标解锁）。跳过这步，subl --project 或 build system 里的 shell 调用会静默失败，Alfred/Keyboard Maestro 也无法触发编辑器——因为 GUI 进程根本没被系统真正授权启动。
别手动改 Info.plist 或执行 xattr -d com.apple.quarantine，这会破坏 AppleScript 集成能力，后续自动化脚本找不到进程句柄。
Linux 安装别碰第三方 deb/rpm 包
Ubuntu/Debian 用户务必用官方 APT 源：
wget -qO - https://download.sublimetext.com/sublimehq-pub.gpg | sudo apt-key add - echo "deb https://download.sublimetext.com/ apt/stable/" | sudo tee /etc/apt/sources.list.d/sublime-text.list sudo apt update && sudo apt install sublime-text
直接双击下载的 .deb 包安装，会导致 subl 命令不可用、GUI 权限异常、Package Control 初始化失败。官方源能确保 subl 注册为系统命令，并自动配置 MIME 类型关联。
Package Control 不是“装完重启就完事”
控制台（Ctrl + `）粘贴安装代码后，必须重启 Sublime Text，且左下角出现 Package Control 提示才算成功。常见失败原因：
- 网络被墙导致
urllib.request.urlopen超时（可换国内镜像或手动下载Package Control.sublime-package放入Installed Packages目录） - 安装时没勾
Add to PATH（Windows）或没过 Gatekeeper（macOS），导致插件初始化阶段调用系统命令失败 - Linux 下用非官方源安装，
sublime.installed_packages_path()返回路径权限错误
真正卡住人的不是安装步骤多，而是某个环节权限/路径/签名没对齐，导致后续所有插件、汉化、快捷键都变成“看似装了，实则失效”。
