package control装不上需先确认sublime text 4版本≥4107，再执行官网installation.py脚本或手动将package control.sublime-package拖入installed packages目录，成功标志为ctrl+shift+p可运行list packages命令。
Package Control 装不上？先看版本再动手
Sublime Text 4 用户如果按旧教程复制脚本却搜不到 Install Package，大概率是用了 ST3 或更早的安装代码——ST4 必须用官网当前有效的 installation.py 脚本，否则静默失败，控制台不报错、菜单项残留但点不动。
- 打开
Help → About Sublime Text，确认顶部显示的是Sublime Text 4（不是“ST4”或“v4”这种简写） - 别信“自动检测版本”的第三方脚本，ST4 和 ST3 的
sublime.installed_packages_path()返回路径结构不同，混用会导致Package Control.sublime-package被写进错误目录 - Windows 用户注意：安装包名必须是
sublime_text_build_4169_x64_setup.exe（2026 年最新稳定版），其他 build 号可能缺失对 Python 3.11 运行时的支持，导致插件加载失败
控制台执行失败？换手动方式最稳
网络超时、代理拦截、或复制时带不可见 Unicode 字符，都会让 import urllib.request... 一行脚本卡住或报 ImportError: No module named 'package_control'。这时候别反复粘贴，直接切手动。
- 关闭 Sublime Text
- 菜单
Preferences → Browse Packages…→ 关闭窗口 → 向上退一级进Installed Packages/目录（不是Packages/） - 下载
https://packagecontrol.io/Package%20Control.sublime-package，文件名必须一字不差，不要解压、不要改名、不要放进Packages/ - 拖入
Installed Packages/后重启，按Ctrl+Shift+P输入Package Control: List Packages，能返回列表才算真生效
装插件卡在 “Installing…”？不是插件问题，是网络问题
Package Control 默认只认 https://packagecontrol.io，不支持配置代理、镜像源或 HTTP fallback。国内直连失败时，命令面板会空白转圈，不是插件源挂了，也不是你操作慢。
- 科学上网是唯一可靠解法；若不可行，就离线安装：去
https://packagecontrol.io/packages/插件名下载 ZIP，解压后整个文件夹扔进Packages/目录（比如ChineseLocalizations） - 插件名大小写敏感：
ConvertToUTF8写成converttoutf8就搜不到；BracketHighlighter要加"content_highlight_bar": true才显示竖线，漏掉这行等于没装 - 汉化插件
ChineseLocalizations装完自动生效，不用重启；界面仍是英文？说明没装进Packages/，重装一次即可
C++ 编译跑不起来？Build System 和 Key Bindings 别搞混
很多人按了 F5 没反应，就去改 Key Bindings，结果发现还是不行——根本原因是 Build System 没选对，和快捷键无关。
- 必须手动进
Tools → Build System → C++17选中它，否则F5触发的是默认空构建系统 -
Key Bindings里写的"variant":"Run"是指调用build命令的变体，不是“运行”本身；没选对 Build System，variant就没意义 - Build 文件名必须是
C++17.sublime-build（含+和数字），不能叫cpp17或c++，否则selector不匹配，source.c++文件不会触发构建
