Package Control安装失败主因是路径错误、版本不匹配、证书过期或channel失效；需将.sublime-package放Installed Packages/、按sublime.version()选对应脚本、更新cacert.pem、换清华镜像源并完全重启。
安装时必须勾选 Add to PATH（Windows）或运行 shell command（macOS）
不这么做，后续所有命令行调用都会失败——比如你想在终端里输入 subl . 打开当前项目，结果报错 command not found: subl。这不是插件没装好，是根本没注册到系统路径。
Windows 用户安装向导里务必勾选 Add to PATH，否则哪怕你手动把 sublime_text.exe 所在目录加进环境变量，也容易因 UAC 权限或用户配置文件加载顺序出问题。macOS 用户装完后必须打开 Sublime Text，执行 Preferences → Browse Packages…，然后在弹出的 Finder 窗口上层目录里找到 osx_shell_commands.sh 并双击运行；这个脚本会把 subl 命令软链到 /usr/local/bin/，否则 subl --new-window 就只是个摆设。
Linux 用户若用 apt install sublime-text 安装，注意官方源默认不带 subl 命令，得自己建软链接：sudo ln -s /opt/sublime_text/sublime_text /usr/local/bin/subl。
多窗口不是“新建标签页”，而是启动独立进程
很多人点菜单里的 File → New Window 或按 Ctrl+Shift+N，发现新窗口还是和旧窗口共享侧边栏、项目树、甚至设置——因为那只是 UI 层的“新标签组”，不是真正的新进程。
要开互不干扰的独立窗口，必须走命令行：
- Windows：打开 CMD 或 PowerShell，执行
subl --new-window - macOS/Linux：终端里运行
subl --new-window - 想直接从文件管理器打开独立窗口？右键文件 → “Open with Sublime Text” 不行，得用命令行封装：比如 Windows 写个批处理，macOS 配 Automator 调用
subl --new-window "$1"
关键区别在于：每个 --new-window 启动的实例都有自己的 data/Packages/User/ 目录副本，改一个窗口的 Preferences.sublime-settings 不会影响另一个。
中文乱码、保存失败、插件不加载，八成是 data 目录位置错了
Sublime Text 的配置、插件、缓存全存在 data 目录下。默认位置很隐蔽：
- Windows：
%APPDATA%\Sublime Text 3（不是安装目录！） - macOS：
~/Library/Application Support/Sublime Text 3 - Linux：
~/.config/sublime-text-3
如果你用的是便携版（portable version），data 就在解压目录里；但一旦你误删了它，又没备份，所有插件、自定义快捷键、甚至已安装的 Package Control 都会消失——重装编辑器也救不回来。
更麻烦的是权限问题：Windows 上如果 data 在 C:\Program Files\ 下，UAC 会阻止写入，导致保存文件时报 Permission denied；macOS 上若 data 被放在 iCloud 同步目录里，可能因文件锁导致插件加载失败。
Package Control 安装失败？先确认 Python 环境和网络代理
控制台里粘贴那段 import urllib.request... 代码后没反应，或者报 URLError: ，大概率不是代码错了，是网络卡在 DNS 或代理上。
Sublime Text v3/v4 内置 Python 3.3+，但不支持 HTTPS 证书验证绕过。如果你公司内网有 SSL 中间人代理，或者本地开了 Clash/Surge，得手动配置：
- Windows/macOS：在 Sublime 控制台里先运行
import ssl; ssl._create_default_https_context = ssl._create_unverified_context，再跑安装命令 - 或者改用离线安装：下载
Package Control.sublime-package文件，扔进data/Installed Packages/目录，重启编辑器
另外注意：v4 默认禁用旧版插件（如 Vintage、Emacs Mode），如果装完 Package Control 后搜不到常用插件，去 Preferences → Package Control Settings – User 里加一行 "install_prereleases": true。
最常被忽略的一点：多个窗口各自维护一套 data，意味着你在 A 窗口装的插件，B 窗口默认看不到——除非你把插件装在共享的 Packages/ 目录（非 User/），或者用符号链接统一指向同一份配置。
