package control 必须用 https 官方代码安装，旧教程中指向 http 的含 hashlib.sha256 校验的代码已彻底失效；正确做法是访问 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1，复制 sublime text 4 标签页的完整 python 代码（开头为 import urllib.request, os, ssl），在控制台执行，并确保编辑器完全加载、代码无空格或换行错误。
Package Control 必须用 HTTPS 官方代码安装
旧教程里那段含 hashlib.sha256 校验、指向 http://packagecontrol.io/ 的安装代码已彻底失效。2026 年 Sublime Text 4 默认强制 HTTPS，调用 HTTP 地址会直接报错：URLError: <urlopen error eof occurred in violation of protocol></urlopen>。
正确做法只有一步：打开官网 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1，选“Sublime Text 4”标签页，复制当前页面显示的完整 Python 代码（开头是 import urllib.request, os, ssl），粘贴进控制台（Ctrl + `）执行。
常见坑：
- 没等编辑器完全加载就执行——控制台报
NameError: name 'sublime' is not defined，重启后再试 - 复制时多了一个空格或换行——整段代码执行失败，建议用鼠标双击选中整块代码再复制
- Linux 下用 APT 安装的用户，
subl命令能运行但控制台打不开？说明 GUI 进程未完全初始化，先新建个文件再试
语言支持插件别乱装，优先用官方语法包
Sublime 默认自带 Python、JavaScript、C++、HTML 等主流语言的语法高亮，靠的是内置的 .sublime-syntax 文件。很多所谓“Python 插件”其实只是包装了已有语法，还可能冲突。
真正需要额外装的，是三类：
-
带 LSP 支持的智能补全插件：比如
SublimeLSP+ 对应语言服务器（pyright、typescript-language-server），不是Anaconda（已停止维护，且与 ST4 冲突） -
非标准后缀文件绑定：如
.inp（ANSYS）、.vue（老版本不识别），不用装“高亮插件”，而是右下角点语言名 →Open all with current extension as…→ 选INI或Vue Component -
老旧项目必需的 Python 2 插件：如果维护 Build 3114 项目，
Vintageous、SublimeCodeIntel这类必须从 GitHub 手动下载.sublime-package文件，放进Packages/User/目录才生效
构建系统（.sublime-build）要按语言分文件，别堆在一个里
混合开发时最常踩的坑，就是把 C++、Python、Go 的编译命令全塞进一个 Build System，结果切换语言时总跑错命令。
正确做法是每个语言单独建一个 .sublime-build 文件：
- C++：保存为
C++.sublime-build，selector设为"source.c++" - Python：保存为
Python.sublime-build，shell_cmd用python "$file"，selector是"source.python" - 自定义脚本语言（如 Lua + C 混合）：用
cmd数组写多步命令，避免 shell 字符串拼接出错
关键点：selector 字段必须和当前文件的语法 scope 严格匹配，可通过 Ctrl+Shift+P → Developer: Show Scope Name 查看真实值。
中文界面状态栏乱码？不是汉化没装好，是字体没配对
装完 ChineseLocalization 后菜单正常但状态栏一堆方块，90% 是因为默认字体不支持中文。Windows 默认 Consolas、macOS 默认 Menlo 都不含中文 glyph。
解决方法只有一处修改：
- 打开
Preferences → Settings - 在右侧用户设置里加一行：
"font_face": "Microsoft YaHei SC"（Windows）或"font_face": "PingFang SC"（macOS） - 必须选带
SC（Simplified Chinese）后缀的字体，SimSun在高分屏上会糊，Noto Sans CJK SC是跨平台稳妥选择
注意：font_options 如果被汉化补丁篡改过（比如加了 no_round），会导致 retina 屏渲染异常，直接删掉这一行即可。
