必须先安装package control,它是所有插件的前提;sublimelinter需搭配sublimelinter-eslint及项目级配置(如.eslintrc.js)才生效,否则标红、提示均失效。

没装 Package Control,其他插件全白搭——它不是“之一”,是唯一必须手动装、且必须装对的前置项。
Package Control 安装失败的 3 个硬性卡点
Sublime Text 4 已彻底切换到 Python 3,旧版安装脚本里用 urllib2 或缺 hashlib.sha256 校验的,执行后看似成功,实则 Package Control: Install Package 命令无响应。
- 必须用官网 packagecontrol.io 页面明确标注 “Sublime Text 4” 的完整脚本(含
h = 'df21e130' + 'eea76'这类 SHA256 校验值) - 粘贴进控制台(
Ctrl+`)后回车,看到Success! Please restart Sublime Text才算初步成功 - 重启后按
Ctrl+Shift+P输入Package Control: Install Package,左下角出现Fetching list of available packages且不报错,才算真正就位
若命令无反应:先执行 Package Control: Synchronize Sources;仍失败,大概率是代理干扰,临时关掉再试。
前端写 HTML/CSS/.vue 必配 Emmet + AutoFileName
Emmet 不是“锦上添花”,是每天省下几十次手动敲标签的刚需。但它的缩写只在语法识别正确的上下文中生效:
- 在
.html文件中输入section>div.container>ul>li*3按Tab,立刻生成嵌套结构 - 在
.vue文件的<template></template>区域,必须先装Vue Syntax Highlight并确认右下角状态栏语法已切为Vue,否则缩写完全不触发 -
AutoFileName默认只扫描通过Project → Add Folder to Project设置的项目根目录;没设根目录,它连同级assets/img/都找不到 - Webpack 别名(如
@/components)不被识别,路径补全会失效,得靠ESLint提前报错拦住
SublimeLinter 标红失效,90% 是配置断链
SublimeLinter 本身不检查任何东西,它只是个调度器。没配套 linter,编辑器不会标红、不会提示、不会做任何事。
- 必须同时装三个:框架
SublimeLinter+ 执行器SublimeLinter-eslint+ 项目级配置(根目录要有.eslintrc.js或package.json中定义eslintConfig) - 如果保存后没反应,先看右下角状态栏是否显示
ESLint: OK;显示?或No config found,说明配置文件缺失或路径不对 - 全局安装的
eslint和项目本地node_modules/.bin/eslint版本冲突时,插件常静默失败;优先让SublimeLinter-eslint走项目内二进制路径 -
stylelint同理,必须有.stylelintrc或stylelint.config.js,否则对 CSS 文件完全静音
别忽略中文和 Git 协作的底层细节
中文乱码、光标错位、Git 变更看不见——这些不是“小问题”,而是日常打断流的高频痛点。
-
ConvertToUTF8解决非 UTF-8 编码文件(如 GBK)打开即乱码;但若文件本身是 UTF-8-BOM,它反而可能误转,建议搭配File Encoding Manager精准识别 -
IMESupport专治 Windows 下中文输入法光标悬浮异常、回车后跳行、选中文本光标消失等问题,装完无需配置即生效 -
GitGutter在行号旁显示+/-/→图标,但前提是当前文件属于 Git 仓库且已添加到索引;未git add的新文件不会标记 -
SideBarEnhancements补全右键菜单:快速复制路径、在终端打开、新建文件夹等,但它的“在浏览器中打开”对file://协议支持不稳定,推荐用OpenInBrowser替代
最易被忽略的是:所有插件都依赖当前文件的语法识别模式。右下角状态栏显示 Plain text 时,Emmet、Linter、AutoFileName 全部失能——切语法不是可选项,是必操作。











