sublime Text 需通过 SublimeLinter 框架与 SublimeLinter-eslint 插件集成 ESLint 实现 js 语法检查,须确保本地已安装 ESLint 并正确配置可执行路径及 .eslintrc 配置文件。

sublime text 本身不带 javaScript 语法检查功能,需要借助插件集成 ESLint 实现实时 lint。核心是安装 SublimeLinter 框架 + SublimeLinter-eslint 插件,并确保系统已全局或项目级安装 ESLint。
安装 SublimeLinter 和 ESLint 插件
打开 Sublime Text,按 Ctrl+Shift+P(windows/linux)或 Cmd+Shift+P(macOS),输入 Install Package,回车后搜索并安装:
- SublimeLinter(基础框架,必须先装)
- SublimeLinter-eslint(ESLint 专用 linter 插件)
安装完成后重启 Sublime(部分版本需手动重启)。
确认 ESLint 已正确安装
SublimeLinter-eslint 不自带 ESLint,它依赖你本地的 ESLint 可执行文件。请在终端运行:
立即学习 “Java 免费学习笔记(深入)”;
eslint --version
若提示 command not found,请先安装:
- 全局安装:
npm install -g eslint - 或项目内安装:
npm init -y && npm install eslint --save-dev,然后配置 Sublime 使用项目内路径(见下一条)
配置 ESLint 路径与规则
点击菜单 Preferences → Package Settings → SublimeLinter → Settings,在右侧用户设置中添加或修改:
{"linters": { "eslint": { "executable": [ "./node_modules/.bin/eslint" ], "args": ["--config", ".eslintrc.js"] } } }
说明:
-
executable:指向项目内 ESLint(推荐,避免全局污染);若用全局 ESLint,可写"eslint"或完整路径如"/usr/local/bin/eslint" -
args:指定配置文件位置,确保项目根目录有.eslintrc.js、.eslintrc.json或.eslintrc.cjs
没有配置文件?运行 npx eslint --init 交互生成一个。
启用保存时自动修复(可选)
SublimeLinter-eslint 默认只报错不修复。如需保存时自动 fix(如缩进、分号),需额外配置:
- 安装插件 ESLint-Formatter(非 SublimeLinter 系列,独立 formatter)
- 或使用 SublimeLinter-contrib-eslint_d(提升性能)配合自定义命令
- 更简单方式:用 JsPrettier 插件 + ESLint 配置联动(需开启
"auto_format_on_save": true)
注意:自动修复需 ESLint 规则中明确标记 fixable: "code"(如 semi, quotes),且不能修复逻辑错误。
基本上就这些。配好后打开 .js 文件,语法错误和警告会以波浪线标出,光标悬停显示详情,侧边栏也有问题汇总。不复杂但容易忽略 ESLint 路径和配置文件位置。
以上就是