sublime text 的高效使用始于正确安装：windows需勾选“add to path”和“associate with files”，macos须通过“仍要打开”解除gatekeeper拦截，linux应使用官方apt源；路径、权限与初始化不洁会导致cli、gui集成及package control失效。
别装“汉化整合包”，也别跳过命令行注册步骤——Sublime Text 的效率起点不在插件，而在安装那一刻的路径、权限和初始化是否干净。
Windows 下必须勾选的两个安装选项
安装时勾选 “Add to PATH” 和 “Associate with files” 不是可有可无的细节，而是后续能否在终端里敲 subl . 打开项目、双击任意 .py 或 .json 文件直接唤起编辑器的底层开关。
- 没勾
Add to PATH：你在 PowerShell 或 CMD 里执行subl --command会报错'subl' is not recognized，所有自动化脚本、Git commit hook、CLI 工具链都会断掉 - 没勾
Associate with files：右键菜单里不会出现 “Open with Sublime Text”，你得手动拖文件进窗口，批量处理日志或配置时效率直接打五折 - 安装路径建议保留默认（
C:\Program Files\Sublime Text），避免中文路径或空格导致 Python 插件加载失败，尤其影响Package Control的urllib请求路径解析
macOS 上绕过“已损坏”提示的正确姿势
从官网下载的 .dmg 挂载后拖入 /Applications，首次启动时系统弹出“已损坏，无法打开”不是病毒警告，而是 macOS Gatekeeper 对未签名二进制的默认拦截——不能点“取消”，也不能用第三方“破解工具”绕过。
- 正确操作是：右键 Dock 中的 Sublime Text 图标 → 选择“显示简介” → 勾选“仍要打开”（macOS Sonoma 起改为点击锁图标解锁后勾选）
- 之后再通过终端运行
subl --command才能真正打通 Shell 与 GUI 进程通信，否则subl --project或自定义 build system 里的 shell 调用会静默失败 - 别手动改
Info.plist或执行xattr -d com.apple.quarantine，这会破坏 AppleScript 集成能力，导致后续用 Alfred 或 Keyboard Maestro 触发编辑器时找不到进程
Linux 用户该用 apt 还是 tarball？
Ubuntu/Debian 系统请严格走官方 APT 仓库，别用 apt install sublime-text 安装旧版源里的阉割包，更别手动解压 tarball 后硬加 alias subl=... ——后者会导致 D-Bus session bus 无法识别编辑器实例，多窗口协同、文件监听（如 SideBarEnhancements 的实时刷新）全部失效。
- 正确流程：先导入 GPG 密钥
wget -qO - https://download.sublimetext.com/sublimehq-archive.gpg | sudo apt-key add -，再添加源deb https://download.sublimetext.com/ apt/stable/ - 安装后运行
subl --version应输出类似Sublime Text Build 4200，而非unknown或空值；若为空，说明subl命令未绑定到正确的二进制路径（通常是/opt/sublime_text/sublime_text） - 桌面环境集成靠
/usr/share/applications/sublime_text.desktop，手动解压用户目录下的版本没有这个文件，GNOME/KDE 启动器里搜不到它，也无法设为默认文本编辑器
Package Control 安装失败的三个真实原因
控制台粘贴那段 Python 安装代码后没反应、报 URLError、或重启后左下角没出现 Package Control 提示，大概率不是网络问题，而是环境卡点没对齐。
-
sublime.installed_packages_path()返回空：说明 Sublime Text 没完成首次初始化，需手动创建~/.config/sublime-text-4/Installed Packages/（Linux/macOS）或%APPDATA%\Sublime Text\Installed Packages\（Windows）目录 - HTTPS 被代理劫持：公司内网或校园网常拦截
https://packagecontrol.io/的证书，此时应改用 HTTP 镜像（注意仅限临时调试）：http://packagecontrol.cn/，但记得装完插件后立刻切回 HTTPS 源 - Python 版本不匹配：ST4 默认用 Python 3.8 运行插件，而你粘贴的安装代码若来自 ST2/ST3 旧文档（含
hashlib.sha256校验逻辑），可能因字符串编码差异写入空文件，表现为Package Control.sublime-package文件大小为 0 字节
真正卡住人的从来不是“怎么装”，而是装完之后发现 Ctrl+Shift+P 打不开命令面板、ChineseLocalization 装了但界面还是英文、或者 subl 在终端里能运行却无法响应 --project 参数——这些都不是软件 bug，是安装时某一个路径、权限或协议层没对齐留下的毛刺。拧紧它，比装十个插件都管用。
