sublime text命令行不可用的根本原因是安装时未勾选“add to path”或未正确配置环境变量，windows需重装并勾选该选项，macos需通过菜单安装命令行工具，linux需手动建软链接，验证用which subl或where subl。
Sublime Text 装完不能用，不是软件问题，是安装时漏掉了几个关键开关——尤其是 Add to PATH 和 Add to explorer context menu，这两个不勾，后续所有命令行调用、右键打开、Git 集成全失效。
Windows 安装必须勾的三项配置
双击 sublime_text_build_*.exe 后，在 “Select Components” 页面，以下三项必须手动勾选：
-
Add to explorer context menu：不勾，右键任意文件 → “Open with” 里根本找不到 Sublime Text -
Add to PATH：不勾，终端输subl .直接报错'subl' is not recognized，Git commit message 编辑器也 fallback 到 vim -
Create a desktop shortcut：非强制但强烈建议，尤其新手别依赖开始菜单搜图标（UOS/Win11 开始菜单索引常延迟）
路径别改，默认 C:\Program Files\Sublime Text 最稳；若非要改到 D 盘，确保路径不含中文或空格，否则 build system 里写 "cmd": ["python", "$file"] 会因路径解析失败直接静默退出。
Package Control 安装失败的真正原因
很多人 Ctrl+` 粘贴官方脚本后没反应，或重启后左下角没出现 Package Control 提示，本质是网络或权限问题，不是脚本错了：
- 国内环境大概率被 DNS 污染，
http://packagecontrol.io/域名解析失败——改用 HTTPS 地址：https://packagecontrol.io/ - ST4 用户必须用含
sha256校验的安装脚本，旧版脚本在 ST4 上会静默失败（无报错，但Installed Packages目录里没生成Package Control.sublime-package） - 杀毒软件/防火墙拦截了 Python 的
urllib.request.urlopen请求——临时禁用再试，或手动下载Package Control.sublime-package放到sublime_text\Data\Installed Packages\目录
验证是否成功：重启后按 Ctrl+Shift+P，能呼出命令面板且输入 Install Package 有响应，才算真正就位。
ChineseLocalization 插件不生效的隐藏条件
装完插件仍显示英文界面？不是插件没装，是它被 ignored_packages 黑名单屏蔽了：
- 打开
Preferences → Settings，检查右侧用户设置里是否有"ignored_packages": ["ChineseLocalization"]——如果有，删掉整行或把"ChineseLocalization"从数组里移除 - 某些汉化整合包会篡改
Default/Preferences.sublime-settings中的font_options字段，导致高分屏渲染异常，进而触发 Sublime 自动禁用该插件 - UOS 系统需额外确认：应用商店安装的版本可能自带沙箱限制，
Package Control无法写入Installed Packages目录——此时应改用官方 RPM 仓库安装（sudo dnf install sublime-text）
改完设置后必须重启 Sublime Text，热重载不生效。
命令行 subl 不可用的系统级修复
即使安装时勾了 Add to PATH，某些 Win11 或 UOS 环境仍提示 subl 找不到，是因为 PATH 没刷新或 shell 启动时未加载：
- Windows：打开新终端（不是已打开的旧窗口），运行
where subl，若返回路径则说明 PATH 生效；否则手动把C:\Program Files\Sublime Text加进系统环境变量 - macOS：检查
~/.zshrc是否包含export PATH="/Applications/Sublime Text.app/Contents/SharedSupport/bin:$PATH"，没有就加上并source ~/.zshrc - Linux（UOS/Ubuntu）：确认
/usr/bin/subl是指向官方二进制的软链，不是某个旧版本残留——ls -l /usr/bin/subl，若指向错误，用sudo ln -sf /opt/sublime_text/sublime_text /usr/bin/subl重置
最易被忽略的是：Windows 的 PowerShell 默认不读取 GUI 应用注册的 PATH，必须用 CMD 或 Windows Terminal 启动，否则 subl 永远找不到。
