Package Control必须先安装，否则无法安装任何插件；2026年最新安装方式为一行Python命令，粘贴至Ctrl+`控制台执行，成功后需重启Sublime Text才能在Ctrl+Shift+P中看到Install Package选项。
Package Control 必须先装，否则所有插件都装不了
没装 Package Control 就去搜 Git 或 ColorHighlighter，命令面板里根本不会出现安装选项——它不是插件，而是插件的“开关”。
2026 年最新稳定安装方式只有一行命令，别信旧教程里分段粘贴的 Python 脚本：
import urllib.request,os; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); open(os.path.join(ipp,pf),'wb').write(urllib.request.urlopen('https://packagecontrol.io/'+pf.replace(' ','%20')).read())
按 Ctrl+` 打开控制台，粘贴回车即可。装完必须重启 Sublime Text，否则 Ctrl+Shift+P 里搜不到 Install Package。
常见卡点：
- 网络超时：换源不现实，直接重试；偶尔
https://packagecontrol.io/响应慢，等 10 秒再试 - 报错
No module named 'urllib.request'：说明你用的是 Sublime Text 2，已停止维护，必须升级到 ST4 - 装完仍无反应：检查
~/.config/sublime-text/Packages/下是否有Package Control.sublime-package文件，没有就重装
Linux 下装 Git 插件后 git status 轮询拖慢大仓库响应
Git 插件默认每秒调一次 git status，在几十万文件的 monorepo 里会明显卡顿，光标移动延迟、保存变慢。
关掉轮询就能恢复流畅：
- 打开
Preferences → Package Settings → Git → Settings – User - 填入以下配置（只保留必要项）：
{
"git_timeout": 5,
"git_gutter_enabled": true,
"git_status_bar_enabled": true,
"git_status_bar_show_branch": true,
"git_status_bar_show_dirty": true,
"git_status_bar_show_staged": false,
"git_status_bar_show_untracked": false,
"git_status_poll_interval": 0
}
"git_status_poll_interval": 0 是关键，关掉自动轮询；手动刷新用 Ctrl+Shift+P → Git: Refresh Status 即可。
注意：git 命令必须在 $PATH 中，否则插件启动就报 git not found；Ubuntu/Debian 默认有，CentOS/RHEL 需先 sudo yum install -y git 或 sudo dnf install -y git。
中文界面和代码着色插件要配齐，单装一个没用
ChineseLocalizations 和 ColorHighlighter+ColorPicker 是两组独立需求，但各自内部不能拆开。
汉化流程：
Ctrl+Shift+P → Package Control: Install Package → ChineseLocalizations- 装完不用重启，立刻生效；再进
Help → Language → 简体中文 - 如果菜单仍是英文，检查是否误装了
Localization（旧版）或ChineseLocalization（少个 s），删掉重装
颜色相关插件必须成对装：
-
ColorHighlighter负责高亮#ff0000、rgb(255,0,0)这类值 -
ColorPicker提供Ctrl+Shift+C取色并插入十六进制值 - 只装一个，要么看不见颜色块，要么取了色插不进代码
装完测试：光标停在 color: 后按 Ctrl+Shift+C，点屏幕任意位置，应自动补全为 #4ecdc4 格式。
软链接和桌面图标漏建，subl 命令就跑不起来
APT 安装后 subl 命令可用，是因为官方 .deb 包自带 /usr/bin/subl 软链接；但 tar.xz 或 rpm 手动安装后，这步得自己来。
常见错误现象：
- 终端输
subl报command not found - 桌面右键没有
Open with Sublime Text选项 - 点击应用菜单图标启动后，任务栏显示 “Sublime Text” 而非具体文件名（说明 desktop 文件没配好）
补救步骤（以 tar.xz 解压到 /opt/sublime_text 为例）：
- 建终端命令：
sudo ln -s /opt/sublime_text/sublime_text /usr/bin/subl - 建桌面入口：
sudo cp /opt/sublime_text/sublime_text.desktop /usr/share/applications/ - 验证：
subl --help有输出，且ls /usr/share/applications/ | grep sublime能看到 desktop 文件
真正容易被忽略的是 /etc/apt/keyrings/ 目录权限：如果非 root 用户执行过密钥导入命令，apt update 可能报 NO_PUBKEY，删掉 /etc/apt/keyrings/sublimehq-pub.asc，切回 root 重跑导入命令就行。
