应直接从官网下载安装包,避免第三方链接;windows选“download for windows”,macos选.dmg,linux按发行版选.deb或.rpm;安装时注意系统位数匹配、勾选path和快捷方式;用ctrl+`安装package control最新代码;中文界面通过用户设置添加"locale": "zh-cn";插件通过命令面板精准搜索安装。

直接下载官方安装包,别碰第三方网盘链接
Sublime Text 官方网站 https://www.sublimetext.com/ 是唯一可信来源。Windows 用户点 “Download for Windows”,macOS 用户选 .dmg,Linux 用户按发行版选 .deb 或 .rpm。所有非官网链接(尤其是带“quark.cn”“Crack”“License”字样的)都极大概率混入篡改二进制、注入广告或绕过签名验证——这会导致后续 Package Control 安装失败、插件加载报 ImportError: No module named 'urllib.request',甚至编辑器启动后直接崩溃。
常见错误现象:双击安装包没反应、安装完图标不显示、右键菜单里找不到“Open with Sublime Text”。根本原因往往是下载了加壳的盗版包,或 32/64 位系统错配(比如在 Win11 64 位上装了 32 位版本)。
- Windows:务必勾选 “Add to PATH” 和 “Create a desktop shortcut”,否则后续无法在终端用
subl命令打开项目 - macOS:安装 .dmg 后拖拽到
/Applications,再手动运行一次subl --install-cmd(不是subl --command),否则终端调用会提示command not found - Linux:用
sudo apt install sublime-text安装的版本常因缺少libglib2.0-0报错,建议直接下载 .deb 并用sudo dpkg -i安装
用 Ctrl+` 装 Package Control,别复制粘贴旧代码
Sublime Text 启动后,立刻按 Ctrl+`(反引号,不是单引号)打开控制台。粘贴的安装代码必须匹配当前版本——Sublime Text 4 要求使用 Python 3 兼容写法,老教程里 import urllib2 或 urllib.urlopen 已失效,会直接卡住控制台并抛出 NameError: name 'urllib2' is not defined。
正确代码(2026 年实测可用):
import urllib.request,os; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); open(os.path.join(ipp, pf), 'wb').write(urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read())
执行后重启编辑器,左下角出现 “Package Control” 提示才算成功。若无提示,说明网络被拦截(国内需确认是否配置了代理),或 sublime.installed_packages_path() 返回空路径(常见于 Portable 模式未初始化)。
中文界面和基础设置,改 user-settings 就行
别折腾插件汉化——ChineseLocalization 插件已停止维护,Sublime Text 4 内置多语言支持,只需改用户配置。按 Ctrl+, 打开 Preferences → Settings,右侧用户设置里加两行:
{
"locale": "zh-CN",
"font_size": 13
}
这样既避免插件冲突,又省去重启步骤。其他高频配置可一并加入:
-
"word_wrap": true:长行自动换行,不用横向滚动 -
"highlight_line": true:高亮当前行,减少光标定位误差 -
"default_encoding": "UTF-8":强制默认编码,防止打开 .py 文件时中文注释变乱码 -
"save_on_focus_lost": true:切窗口时自动保存,避免忘存导致修改丢失
注意:所有键名必须用英文双引号,值为字符串时也必须加引号,漏掉任一引号会导致整个配置失效,编辑器会静默回退到默认设置。
插件安装别搜名字,用命令面板精准命中
按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)打开命令面板,输入 Install Package 回车,等几秒让 Package Control 加载完成(状态栏会显示 “Loading packages…”)。此时再输插件名——比如想装 BracketHighlighter,直接输 bracket 就能匹配,输 highlight 反而可能跳出一堆无关插件。
容易踩的坑:
- 输错大小写:
emmet可以,Emmet或EMMET会搜不到 - 网络超时:如果搜完无响应,关掉面板重试,不要连续狂按回车——
Package Control有请求限频,触发后要等 60 秒 - 安装后不生效:部分插件(如
GitGutter)需要重启编辑器,但多数(如AutoFileName)即时生效
真正卡住人的从来不是“怎么装”,而是装完发现快捷键冲突、缩进错乱、或者保存时弹出权限错误——那些都得回过头检查安装路径权限、用户配置语法、以及是否误启用了系统级只读策略。











