windows安装sublime text时必须勾选add to explorer context menu（否则右键无“open with sublime text”）、add to path（否则subl命令不可用）、create a desktop shortcut（否则桌面无快捷方式），三者均为硬依赖，跳过则基本功能失效。
Windows安装时必须勾选的三项配置
跳过这三项，后续基本功能就断了：右键打不开、命令行输subl没反应、桌面找不到图标。不是“可选”，是硬依赖。
-
Add to explorer context menu：不勾，右键任何文件都看不到“Open with Sublime Text” -
Add to PATH：不勾，Git 提交时无法用git config --global core.editor "subl --wait"，终端里敲subl .直接报“command not found” -
Create a desktop shortcut：新手别指望从开始菜单翻图标，尤其装完没重启资源管理器时，开始菜单可能压根不显示
路径别改到带中文或空格的目录（比如D:\我的软件\Sublime Text），否则后续配置 Build System 时python -u "$file"会因路径解析失败而报错。
Package Control 安装失败的常见原因
Ctrl+` 打开控制台后粘贴安装脚本却没反应？大概率是网络或权限问题，不是脚本本身错了。
- 国内环境常被 DNS 污染，
http://packagecontrol.io/域名解析失败 → 改用 HTTPS 地址：https://packagecontrol.io/ - ST4 用户必须用含
sha256校验的脚本（官网最新版），旧脚本在 ST4 下会静默失败，无提示也不报错 - 杀毒软件或防火墙拦截 Python 网络请求 → 临时关闭或添加
sublime_text.exe为信任程序
装完后左下角没出现“Package Control”字样，说明没成功；别急着搜插件，先重启编辑器再试一次。
中文界面为什么装了 ChineseLocalization 还是英文
插件装了≠生效。关键卡点在ignored_packages设置和语言切换路径。
- 检查
Preferences → Settings – User里是否手动加了"ignored_packages": ["ChineseLocalization"]——这是最常见误操作 - 汉化后必须走
Help → Language → 简体中文，不是 Preferences 菜单里的任意位置 - 如果界面部分乱码（比如菜单正常但状态栏汉字变方块），说明字体没配对：在
Settings – User里加"font_face": "Microsoft YaHei"或"font_face": "SimSun"
别信“自动汉化”说法——这个插件只提供翻译资源，不自动触发语言切换，手动点一次才生效。
Linux 下 subl 命令无效的排查顺序
Ubuntu/Debian 用户装完sublime-text包，subl仍不可用，问题几乎全出在 PATH 或软链接上。
- 先确认命令是否存在：
which subl，返回空说明没建软链接或 PATH 没包含对应路径 - 官方 APT 安装默认把二进制放在
/opt/sublime_text/sublime_text，但没自动建/usr/bin/subl→ 手动运行：sudo ln -s /opt/sublime_text/sublime_text /usr/bin/subl - 如果
subl能运行但subl --command报错，说明 Shell 启动时没加载完整环境变量 → 把export PATH="/opt/sublime_text:$PATH"写进~/.bashrc或~/.zshrc并重载
UOS 或麒麟等国产系统若用 RPM 安装，dnf install后还需手动补依赖libX11 gtk3 libICE libSM，缺一个subl就起不来，错误信息里会明确写出缺失包名。
