用 apt 安装 sublime text 最省心但需先添加官方源并配置 gpg 密钥,否则报 no_pubkey 或 404;装后需创建 /usr/local/bin/subl 软链接并确保 path 生效;中文显示需在 preferences.sublime-settings 中正确设置 font_face 和 font_options;插件失效多因网络或证书问题,应使用 subl --debug 排查。

用 apt 安装最省心,但得先加官方源
Ubuntu/Debian 系统默认仓库里的 sublime-text 版本老旧(常是 3.x),甚至已下架;直接 sudo apt install sublime-text 很可能报错或装不上。必须先导入 GPG 密钥、添加官方 APT 源。
-
wget -qO - https://download.sublimetext.com/sublimehq-archive.gpg | sudo apt-key add -(旧版 apt)或sudo apt install gpg后改用gpg --dearmor方式(新版 apt 需适配) echo "deb https://download.sublimetext.com/ apt/stable/" | sudo tee /etc/apt/sources.list.d/sublime-text.listsudo apt update && sudo apt install sublime-text
跳过密钥或源配置,安装会失败并提示 “NO_PUBKEY” 或 “404 Not Found”。尤其注意:Ubuntu 22.04+ 默认禁用 apt-key,需手动转成 trusted.gpg.d 方式,否则更新时警告不断。
命令行启动要能用 subl,得检查软链接和 PATH
装完后终端输 subl 报 “command not found”,不是没装好,而是桌面环境没加载新 PATH,或 subl 命令未注册。
- 确认二进制路径是否存在:
ls /opt/sublime_text/sublime_text(官方 apt 包默认装在这里) - 手动创建软链接:
sudo ln -sf /opt/sublime_text/sublime_text /usr/local/bin/subl - 新开终端再试;若仍不行,检查 shell 配置文件(
~/.bashrc或~/.zshrc)是否被其他 PATH 覆盖
常见坑:有人把 subl 链到解压版的本地路径(如 ~/Downloads/sublime_text/sublime_text),一旦删掉那个目录,命令立刻失效——必须指向系统级安装路径。
中文乱码、字体发虚?关键在 fontconfig 配置
Sublime 在 Linux 下默认不读取系统中文字体别名,打开 .txt 或 .py 文件时中文显示方块、英文又模糊,不是编码问题,是字体渲染链断了。
- 编辑
~/.config/sublime-text/Packages/User/Preferences.sublime-settings - 加入这两项:
"font_face": "Noto Sans CJK SC"(或其他已安装的中文字体名,用fc-list :lang=zh查)、"font_options": ["gray_antialias"] - 重启 Sublime;若字体仍不生效,运行
fc-cache -fv刷新字体缓存
别硬套 Windows/macOS 的字体名(如 “Microsoft YaHei”);Linux 下必须用 fontconfig 实际注册的全名,大小写和空格都敏感。漏掉 font_options,HiDPI 屏幕上文字会发虚。
插件装不了或 Package Control 失效?网络和 Python 环境是隐性门槛
点击菜单 “Preferences > Package Control” 没反应,或安装插件后不加载,大概率不是插件本身问题,而是 Sublime 内置的 Python 环境无法联网或证书验证失败。
- Sublime Text 4 自带 Python 3.8,但默认不信任系统 CA 证书;遇到 HTTPS 请求超时或 SSL 错误,可临时在设置里加:
"http_timeout": 30和"https_proxy": "http://127.0.0.1:8080"(如有代理) - 更稳妥的做法:用终端启动,观察输出错误——
subl --debug会打印真实报错,比如 “certificate verify failed” 就说明需要更新证书包 - 别用 pip 安装插件;所有插件必须走 Package Control,否则路径错乱、升级丢失
真正麻烦的是企业内网或 DNS 劫持环境:Package Control 的原始域名 packagecontrol.io 若被墙或污染,即使开了系统代理,Sublime 内置 HTTP 客户端也可能连不上——这时候得手动改 hosts 或换镜像源,不是重装就能解决的。











