Windows安装必须勾选Add to explorer context menu、Add to PATH、Create a desktop shortcut三项，否则右键菜单无入口、命令行无法调用、桌面无快捷方式；路径禁用中文或空格；macOS需Ctrl+右键Dock图标放行；Linux须先导入GPG密钥再添加源；Package Control装后需验证命令可用性及汉化配置。
Windows 安装必须勾选的三项配置
跳过这三项，后续几乎所有扩展功能都会失效：不是插件装不上，而是根本没入口。安装时在 Select Components 页面，必须手动勾选：
-
Add to explorer context menu：不勾，右键菜单里永远找不到“Open with Sublime Text” -
Add to PATH：不勾，命令行输subl .会报'subl' is not recognized，Git 集成、脚本调用全断链 -
Create a desktop shortcut：新手找图标要翻开始菜单，其实双击桌面图标才是最快启动方式
路径别改到带中文或空格的目录（比如 D:\我的软件\Sublime Text），否则后续 Build System 里用到的 ${file_path} 变量会解析失败，编译直接报错。
macOS 上绕过“已损坏”警告的实操动作
从官网下载 .dmg 后双击挂载，拖进 /Applications，首次打开必弹“已损坏，无法打开”。这不是文件问题，是 macOS 的 Gatekeeper 策略拦截——你得手动放行：
- 先不要点“取消”，按住
Ctrl键再右键点击 Dock 中的 Sublime 图标 - 选择“打开”，系统会弹出二次确认，这时点“打开”才真正授权
- 如果已经点了“取消”，去
系统设置 → 隐私与安全性 → 安全性，找到 Sublime 条目点“仍要打开”
别用 Homebrew 安装 sublime-text（非官方 tap），它默认不注册 AppleScript 支持，subl --command 类命令会静默失败。
Linux 用户绕不开的 APT 密钥验证环节
Ubuntu/Debian 下用 apt install sublime-text 装的，大概率是旧版或社区打包版，.sublime-package 插件加载会失败——因为官方签名机制被跳过。正确流程是：
- 先执行
wget -qO - https://download.sublimetext.com/sublimehq-archive.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
漏掉 apt-key add 这步，apt update 会警告 GPG key missing，后续所有更新都卡住，Package Control 也装不上。
Package Control 安装后立即验证的两个动作
装完 Package Control 不代表就 ready，必须立刻验证是否真正生效：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Package Control: Install Package，能列出选项才算成功 - 装完
ChineseLocalization后，检查Preferences → Settings – User里有没有"ignored_packages": ["ChineseLocalization"]这行——有就删掉，否则汉化白装
ST4 要求安装脚本带 sha256 校验，直接粘贴旧版代码会静默失败；且首次运行后需等待 10–20 秒，状态栏才显示 “Package Control Ready”，别急着关窗口。
