错误。安装Package Control并非必须用控制台命令,手动将官方.sublime-package文件拖入Installed Packages目录(不改名、不解压、不放错路径)同样有效,且是网络受限时的推荐替代方案。

安装 Package Control 必须用控制台命令,不能拖文件
Package Control 是 Sublime Text 插件生态的入口,不装它,后续所有插件都装不上。很多人图省事,把 Package Control.sublime-package 文件直接拖进 Packages 目录,结果发现插件列表空白、Install Package 命令不可用——这是典型的“假安装”。
真正起效的方式只有一种:打开控制台(Ctrl+` 或 Cmd+`),粘贴官方最新安装脚本(2026 年仍有效):
import urllib.request,os,subprocess; pf = 'Package Control.sublime-package'; ip = 'https://packagecontrol.io/' + pf; ctx = ssl.create_default_context() if hasattr(ssl, 'create_default_context') else None; urllib.request.install_opener(urllib.request.build_opener(urllib.request.HTTPSHandler(context=ctx))); open(os.path.join(sublime.installed_packages_path(), pf), 'wb').write(urllib.request.urlopen(ip).read())
- Windows 用户注意:控制台输出无报错 ≠ 安装成功,必须重启 Sublime Text 后按
Ctrl+Shift+P输入Package Control: Install Package能响应才算到位 - macOS / Linux 若提示
ssl.SSLError,说明系统 Python 的证书链过旧,临时解决方案是加一句context=ssl._create_unverified_context()替代原ctx - 别信“离线安装包”,多数已失效或带篡改逻辑,尤其会干扰
Preferences.sublime-settings中的ignored_packages字段
中文界面必须改 default_locale,不是装汉化包
所谓“汉化包”本质是覆盖核心资源文件,2026 年 ST4.4.5 版本已彻底移除对第三方汉化补丁的支持。强行替换 Default 包会导致启动卡死、语法高亮错乱,甚至破坏 SideBarEnhancements 等插件的右键菜单。
正确做法是:打开 Preferences → Settings - User,在右侧 JSON 中加入一行:
"default_locale": "zh_CN"
- 保存后立即生效,无需重启(部分菜单项如“Preferences”本身需重开一次窗口才变中文)
- 如果显示为
zh或zh_CN.UTF-8,Sublime Text 会 fallback 到英文,必须严格用zh_CN - 此设置不影响插件语言——插件是否中文化取决于其自身支持,比如
ChineseLocalizations插件已停止维护,勿装
Python 构建系统要手动指定解释器路径,不能只选 Python3
在 Tools → Build System → Python3 下运行脚本失败,常见报错是 python3: command not found 或输出乱码,根本原因是 Sublime Text 默认调用的是系统 PATH 中的 python3,而你实际用的是 conda 环境、pyenv 管理的版本,或者 Windows 上的 python.exe。
解决方法:新建一个构建系统(Tools → Build System → New Build System),写入:
{
"shell_cmd": "/opt/anaconda3/bin/python3 -u "$file"",
"file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
"selector": "source.python"
}- Linux/macOS 路径填你
which python3的真实输出;Windows 填类似C:\Users\xxx\AppData\Local\Programs\Python\Python311\python.exe -
-u参数必须保留,否则 print 输出会缓冲,调试时看不到实时日志 - 别依赖
PATH变量——Sublime Text 启动时读取的是 GUI 环境变量,和终端里echo $PATH往往不一致
主题与字体配置容易忽略 DPI 缩放适配
在 200% 缩放的 Windows 高分屏或 macOS Retina 屏上,直接设 "font_size": 12 会导致文字糊成一团,而设 "font_size": 24 又让行距爆炸——这不是字体问题,是 Sublime Text 对系统缩放因子响应不完整。
稳妥方案是关闭自动缩放,用 font_size + line_height 手动微调:
{
"font_face": "Fira Code",
"font_size": 13,
"line_height": 1.1,
"dpi_scale": 1.0
}-
dpi_scale设为1.0强制禁用内置缩放,让字体渲染完全由操作系统接管 -
line_height推荐值 1.0–1.2,低于 1.0 行间会重叠,高于 1.3 空行太多 - 不要用
theme名字带Retina或HiDPI的旧主题——它们在 ST4 中已被废弃,加载失败会静默回退到默认主题
最麻烦的从来不是装多少插件,而是每处配置背后隐含的环境假设:你的 shell PATH、系统 locale、显卡驱动版本、甚至 Python 解释器编译时用的 SSL 库。这些细节不显眼,但一旦错位,就会让整个工作流卡在“看起来正常,实则处处不对劲”的状态里。


















