sublime text 首次启动必须完成三件事：windows需勾选add to path和add to explorer context menu，并保持默认安装路径；macos需右键dock图标勾选“仍要打开”绕过gatekeeper；启动后须执行package control安装代码，再装chineselocalization和converttoutf8插件，并手动打开乱码gbk文件触发编码转换初始化。
Sublime Text 首次启动不是“点开就用”，而是决定后续所有功能是否正常的关键节点——subl 命令失效、右键菜单空白、GBK 文件乱码、插件安装卡住，90% 都源于首次启动时没做对这三件事。
Windows 下必须勾选的两个安装选项
安装时没勾选 Add to PATH 和 Add to explorer context menu（即“关联文件”），等于给 Sublime 装了轮子却不接传动轴。
-
Add to PATH不勾：你在 CMD/PowerShell 里敲subl .会报错'subl' is not recognized，Git commit hook、脚本自动化、终端快速打开项目全部瘫痪 -
Add to explorer context menu不勾：右键菜单没有 “Open with Sublime Text”，你得手动拖文件进窗口，批量处理配置或日志时效率直接腰斩 - 路径别改：默认装到
C:\Program Files\Sublime Text，别放桌面、别用中文路径、别带空格——Python 插件（比如 Package Control）的urllib请求会因路径解析失败而静默退出
macOS 首次启动绕过 Gatekeeper 的唯一正确操作
首次双击启动弹出“已损坏，无法打开”，不是病毒警告，是 Apple 对未公证二进制的默认拦截。点“取消”或用第三方工具“破解”都会破坏底层集成能力。
- 正确做法：右键 Dock 中 Sublime 图标 → “显示简介” → 勾选“仍要打开”（Sonoma 及更新系统需先点锁图标解锁）
- 不这样做：后续
subl --project、自定义 build system 里的 shell 调用会静默失败，Alfred 或 Keyboard Maestro 触发编辑器时找不到进程 - 别碰
Info.plist或执行xattr -d com.apple.quarantine：这会切断 AppleScript 集成链路，导致 GUI 进程通信不可靠
首次启动后必须立即执行的三步初始化
界面空白不等于就绪，Package Control、编码识别、语言切换都依赖这三步，跳过任何一步都会引发连锁故障。
- 按
Ctrl+`（Windows/Linux）或Cmd+`（macOS）调出控制台，粘贴并回车执行官方安装代码：import urllib.request,os,hashlib;exec(urllib.request.urlopen('https://packagecontrol.io/installation').read().decode('utf-8')) - 装完 Package Control 后，立刻用
Ctrl+Shift+P→ 输入Install Package→ 安装ChineseLocalization（作者 wuub）和ConvertToUTF8（作者 kairyou）——只装前者，GBK 文件打开仍是方块；只装后者，界面还是英文 - 装完
ConvertToUTF8后，**必须手动打开一个乱码的 GBK 文件**，点击右下角编码标识（如UTF-8）→ 选Convert to UTF-8，插件才真正激活自动探测逻辑
最常被忽略的其实是第三步里那个“手动打开乱码文件”的动作——没人告诉你它不是后台自动生效，而是一次性触发式初始化。没点那一下，ConvertToUTF8 就永远在待机状态。
