必须改用 keyring 方式导入密钥并指定 signed-by 路径，安装前需确保 apt-transport-https 已启用，否则 apt update 会报“Unable to locate package”错误。
APT源安装失败：密钥或源地址过时
Ubuntu 20.04/22.04 上用 apt-key add 添加 Sublime Text 密钥会报错，因为该命令已被弃用，且旧密钥路径（如 /etc/apt/trusted.gpg.d/）不再被新版本 apt 信任。
- 必须改用 keyring 方式：执行
wget -qO - https://download.sublimetext.com/sublimehq-pub.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/sublimehq-archive-keyring.gpg > /dev/null - 源地址必须带
[signed-by]参数：写入/etc/apt/sources.list.d/sublime-text.list的内容应为deb [signed-by=/usr/share/keyrings/sublimehq-archive-keyring.gpg] https://download.sublimetext.com/ apt/stable/ - 漏掉
apt-transport-https会导致sudo apt update报 “Unable to locate package” 错误，务必提前运行sudo apt install apt-transport-https
Package Control 安装无响应或报 ImportError
控制台粘贴旧版脚本（含已失效的 php.cn 链接）或被系统 Python 环境干扰，会导致 ImportError: No module named urllib.request 或静默失败。
- 2026 年唯一有效安装命令是：
import urllib.request,os,hashlib;exec(urllib.request.urlopen('https://packagecontrol.io/installation').read().decode('utf-8')) - 若执行后无反应，先检查是否被杀软拦截网络请求；再确认终端里
python3 -c "import urllib.request"能正常执行 - 哈希校验失败不是网络问题，而是脚本被篡改——请手动比对返回内容 SHA256 是否为
df21e130d211cfc94d9b0905775a7c0f1e3d39e33b79698005270310898eea76
汉化后中文乱码：GBK 文件打不开
只装 ChineseLocalization 插件会让菜单变中文，但老项目里的 .js/.html 文件仍显示方块——这不是界面问题，是编码识别缺失。
- 必须同时安装两个插件：
ChineseLocalization（作者 wuub）和ConvertToUTF8（作者 kairyou），缺一不可 -
ConvertToUTF8不会自动生效：需手动打开一个乱码文件 → 点击右下角编码标识（如UTF-8）→ 选Convert to UTF-8，之后同类 GBK 文件才会被正确识别 - 若仍乱码，检查文件真实编码：在终端运行
file -i your_file.js，确认输出含charset=gbk或charset=gb2312
subl 命令不可用或启动报错
安装后终端输入 subl 提示 command not found，或弹出 “Failed to load plugin” 错误，说明 PATH 或插件初始化异常。
-
subl命令默认不创建软链接：运行sudo ln -s /opt/sublime_text/sublime_text /usr/local/bin/subl手动建立 - 首次启动慢是正常现象，但若卡在白屏或报
__init__() got an unexpected keyword argument 'kill_previous'，说明构建系统配置错误——检查Tools → Build System → New Build System…中是否误加了不兼容参数 - Wayland 环境下偶尔闪退：在启动命令前加
env GDK_BACKEND=x11 subl可临时绕过，长期建议升级到 Sublime Text 4 build 4200+
Sublime Text 4 的核心陷阱不在安装步骤本身，而在于每个环节都存在「看起来成功、实际埋雷」的细节：密钥导入方式、Package Control 脚本时效性、GBK 编码处理逻辑、以及 subl 命令的符号链接位置——这些地方一旦跳过验证，后续所有配置都会失效。
