绝大多数Windows用户应选.exe安装包，除非需多版本共存或便携使用；.exe自动配置注册表、右键菜单、文件关联及PATH，是CLI调用（如subl .）、Git集成等的前提，而.zip需手动建Data\Packages\User\目录否则配置会写入%APPDATA%失去便携性。
Windows 下该选 .exe 还是 .zip？
绝大多数 Windows 用户应该选 .exe 安装包，除非你明确需要多版本共存或便携使用。.exe 会自动处理注册表、右键菜单、文件关联和 PATH 注册——这些不是“附加功能”，而是 CLI 调用（如 subl .）、Git 集成、构建系统 shell 调用的必要前提。
容易踩的坑：
- 误选
.zip后没手动建Data\Packages\User\目录，导致插件配置写进%APPDATA%，失去便携性 - 用
.exe安装但没勾选Add to PATH，后续所有命令行操作都会报'subl' is not recognized - 下载了带“汉化版”“绿色版”字样的第三方打包包，内含篡改的 Python 插件或静默进程，Package Control 安装失败率极高
macOS 怎么绕过“已损坏”警告？
官网下载的 .dmg 拖入 /Applications 后首次启动弹出“已损坏，无法打开”，这不是病毒提示，是 Gatekeeper 对未 Apple ID 签名二进制的正常拦截。不能删 quarantine 属性，也不能用第三方工具“解锁”。
正确做法：
- 右键 Dock 中图标 → “显示简介” → 勾选“仍要打开”（Sonoma 及更新系统需先点锁图标解锁）
- 之后再从终端运行
subl --command才能真正打通 GUI 与 Shell 进程通信 - 若跳过这步就直接双击启动，
subl --project或自定义 build system 里的 shell 命令会静默失败，且 Alfred/Keyboard Maestro 触发时找不到进程
Linux 用户该用 apt 还是 tarball？
Ubuntu/Debian 用户必须用官方 APT 仓库，别用 apt install sublime-text 装系统源里的旧版阉割包，也别手动解压 tar.xz 后加 alias subl= —— 这会导致 D-Bus session bus 无法识别编辑器实例。
后果很具体：
- SideBarEnhancements 的实时文件刷新失效
- 多窗口协同编辑（如跨窗口拖拽标签）响应异常
- 构建系统中调用
shell=True的命令可能卡住或无输出
正确流程：先运行 wget -qO - https://download.sublimetext.com/sublimehq-archive.gpg | sudo apt-key add -，再添加 deb https://download.sublimetext.com/ apt/stable/ 源，最后 sudo apt update && sudo apt install sublime-text。
Sublime Text 3 和 4 能否共存？
可以，但必须都用官网页面底部标着 “Portable” 的 .zip 版本，且每个解压目录都要独立初始化。任何混用 .exe 安装器、共享 %APPDATA% 或复用 Package Control 安装脚本，都会导致配置污染或插件加载失败。
关键动作：
- 解压后立刻重命名文件夹，例如
Sublime Text 3 Portable、Sublime Text 4 Stable - 每个文件夹内首次运行前，手动创建空目录：
Data\Packages\User\ - 启动后立刻按
Ctrl+Shift+P→ 输入Browse Packages→ 确认路径指向当前文件夹下的Data\Packages，而非%APPDATA% - ST3 和 ST4 的 Package Control 安装脚本不能互换，Python 运行时不同（3.3 vs 3.8），API 差异会导致控制台卡在 “Installing Package Control”
真正麻烦的不是安装，是验证路径归属和隔离插件环境——很多人以为菜单栏显示“Sublime Text 4”就万事大吉，结果改了一堆设置，在另一个版本里完全不生效。
