Package Control是硬性门槛,未安装则Install Package命令不会出现;验证成功需在命令面板搜“Package Control:”并看到带冒号的子命令列表,否则需重装。

Package Control 必须先装,不是“建议”是硬性门槛
没它,Install Package 命令根本不会出现在命令面板里,所有插件安装路径都会断掉。Windows/Linux 按 Ctrl+Shift+P,macOS 按 Cmd+Shift+P,输入 Install Package Control 回车——这是唯一推荐方式。旧版手动粘贴 Python 脚本的方式已多次因哈希校验失败失效,尤其在 2026 年网络策略收紧后更不稳定。
验证是否成功:再调一次命令面板,搜 Package Control:(注意冒号),能看到一长串带前缀的命令才算落地。如果只看到 Package Control 无冒号、无子命令,说明只是名字加载了,核心功能没起来,得重装。
EditorConfig 插件要配 .editorconfig 文件才生效
光装 EditorConfig 插件没用,它不主动改你的缩进或换行符,只读取项目根目录下的 .editorconfig 文件并强制执行。常见踩坑点:
- 文件名必须是
.editorconfig(开头带点,全小写),写成editorconfig或.editor-config都不识别 - 配置项如
indent_size=2只对当前文件类型生效,需配合[*.js]这类 section 才能精准控制 - 如果 Sublime 已经根据文件内容自动探测出缩进为 4 空格,而
.editorconfig设的是 2,它会强制覆盖——但不会弹提示,只默默改,容易引发协作冲突
中文界面靠 ChineseLocalization,但别指望它翻译全部
ChineseLocalization 插件能汉化菜单、设置项和大部分提示,但它不处理:
- 插件自身的界面文字(比如
BracketHighlighter的状态栏提示仍是英文) - 命令面板里第三方插件注册的命令名(
Emmet: Expand Abbreviation不会变“展开缩写”) - 错误信息和控制台输出(
UnicodeDecodeError这类异常仍原样显示)
如果你依赖中文排查问题,建议同时打开 show_encoding 设置,并在保存前确认右下角显示的是 UTF-8 而非 UTF-8 with BOM——后者在 Windows 下某些插件解析会出错。
主题和字体路径必须用新格式,旧路径直接失效
Sublime Text 4 默认只认 .sublime-color-scheme 后缀的主题文件,.tmTheme 是 ST3 旧格式,2026 年起已彻底弃用。从菜单里点开一个主题后右键选 Copy Path,粘贴出来的就是准确路径,例如:
"color_scheme": "Packages/Color Scheme - Default/Monokai.sublime-color-scheme"
字体设置也一样:"font_face": "Fira Code" 要确保系统已安装该字体,且名称与 fc-list | grep -i fira(Linux/macOS)或字体设置面板中显示的**完整名称**一致。少个空格、大小写不对,都会回退到默认字体。
最易被忽略的是:项目级 .sublime-project 文件里的设置,会完全覆盖用户 Settings,但仅限该项目窗口。新开一个无项目的窗口,哪怕在同一目录,也不会继承这些配置——这点在多项目并行时极易误判为“主题突然变了”。


















