Sublime Text 高效使用需先完成环境校准：Windows 必勾选“Add to PATH”和“Add to context menu”；macOS 需手动创建 subl 符号链接并配置 zsh PATH；Linux 应安装官方 .deb 包而非 apt 源包；Package Control 安装前须确保安装路径可写、系统时间准确、代理设置正确。
Sublime Text 不是装上就能高效用的编辑器，跳过环境校准环节，90% 的后续问题（插件加载失败、subl 命令不可用、中文乱码、构建系统报错）都源于安装阶段的路径、权限或编码策略偏差。
Windows 下必须勾选的两个安装选项
安装向导中「Add to PATH」和「Add to context menu」不是可选项，而是功能基线。不勾选 Add to PATH，你在终端执行 subl . 会提示 'subl' is not recognized；不勾选 Add to context menu，右键菜单里不会出现“Open with Sublime Text”，也无法直接从资源管理器打开项目文件夹。
- 勾选后，安装程序会自动在系统环境变量
PATH中追加C:\Program Files\Sublime Text（或你自定义的安装路径） - 若已安装但漏选，不要重装——手动把该路径加入系统
PATH，再以管理员身份运行一次subl --install-shell-commands - 注意：某些国产“优化工具”会自动清理注册表中的右键项，安装后建议检查注册表
HKEY_CLASSES_ROOT\*\shell\SublimeText是否存在
macOS 上绕不开的 ShellCommands 步骤
仅靠拖拽 Sublime Text.app 到 /Applications 是不够的。subl 命令无法生效，是因为 macOS 的 GUI 应用默认不继承 shell 环境变量，且未注册命令行入口点。
- 必须在终端中执行：
sudo ln -s /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl /usr/local/bin/subl - 如果使用 zsh（macOS Catalina 及以后默认），确认
/usr/local/bin在$PATH中：检查~/.zshrc是否含export PATH="/usr/local/bin:$PATH" - 若仍报
command not found，尝试重启终端或运行source ~/.zshrc；不要用bash兼容模式欺骗自己——zsh 启动流程与 bash 不同
Linux 用户慎用 apt 安装的 sublime-text 包
Ubuntu/Debian 官方源里的 sublime-text 包版本滞后（当前稳定版为 ST4.4.5，apt 源多为 ST3.x），且缺失签名验证机制，导致 .sublime-package 插件无法加载，Package Control 初始化即失败。
- 正确做法：下载官方
.deb包后执行sudo dpkg -i sublime-text_*.deb，再运行sudo apt-get install -f补全依赖 - 关键依赖不能省：至少要确保
libgtk-3-0、libglib2.0-0、libx11-6已安装，否则启动时黑屏或闪退 - 若用 Snap 或 Flatpak 安装，
subl命令默认不可用，需手动创建符号链接，并注意沙盒对文件系统访问的限制（比如无法读取/home/user/.config外的路径）
Package Control 安装失败的三个硬性前提
粘贴那段 Python 安装代码前，请先确认三件事：否则代码会静默失败，且无任何错误提示。
-
sublime.installed_packages_path()返回路径必须可写——Windows 用户若装在C:\Program Files，UAC 可能拦截写入；建议改用%LOCALAPPDATA%\Sublime Text 3\Installed Packages - 系统时间必须准确，误差超过 5 分钟会导致 HTTPS 证书校验失败，
urllib.request.urlopen抛出URLError: [SSL: CERTIFICATE_VERIFY_FAILED] - 代理设置必须与系统一致——如果你用公司网络，Sublime Text 默认不读取系统代理，需在 Preferences → Settings 中手动添加：
"http_proxy": "http://proxy.company.com:8080"
真正卡住人的从来不是某一步操作，而是路径权限、shell 加载顺序、证书时间戳、GUI 进程通信协议这些底层细节——它们不报错，但会让功能断层。装完别急着写代码，先在终端敲 subl --version，再打开命令面板输 Package Control: Install Package，看到搜索框弹出来，才算环境真正就位。
