sublime实现js实时语法检查需sublimelinter框架、sublimelinter-eslint插件及本地eslint可执行文件三者联动,缺一不可;须正确设置语法高亮、executable路径、lint_mode为["on_save","on_modified"]并配置delay与--ext参数。

Sublime 本身不检查 JS 语法,ESLint 实时检查必须靠 SublimeLinter + SublimeLinter-eslint + 本地 eslint 可执行文件三者联动,缺一不可;任何一环断开,状态栏就显示 Plain Text 或 JSON,错误图标也不会出现。
确认文件被识别为 JavaScript(不是 Plain Text)
右下角状态栏显示 Plain Text 或 JSON,说明 Sublime 根本没把当前文件当 JS 处理,SublimeLinter-eslint 压根不会启动。
- 手动设置语法:菜单
View → Syntax → JavaScript(推荐选JavaScript (Babel),兼容 JSX/TSX) - 如果用 Vue 单文件组件,需额外安装
Vue Syntax Highlight插件,并确保.vue文件被识别为Vue Component,否则--ext .vue参数无效 - 无后缀的脚本文件(如
webpack.config)需手动指定语法,否则即使内容是 JS,也触发不了 lint
executable 路径填错是最常见静默失败原因
SublimeLinter-eslint 默认从 $PATH 找 eslint,但 macOS/Linux 多 Node 版本、Windows WSL 混合环境、或用了 nvm/fnm 的用户,which eslint 输出路径往往和 Sublime 继承的 PATH 不一致。
将一个或多个 UI 原型图、线框图、产品截图或设计稿转换为标准化、可直接交付的 PRD 风格文档,供产品、设计、前端和测试共同使用。适用于 Codex 需要分析 PC 网页、桌面端、移动端、响应式页面、独立弹窗、表单、表格、看板、数据大屏或多页面流程截图,还原页面结构与交互,强制套用固定文档模板,抽取跨页面共享规则,或把一组原型沉淀为单页规范文档加整体业务流程文档的场景。不适用于纯视觉审美点评、代码实现、接口设计、埋点方案、竞品分析或无 UI 输入的业务需求创作。
- 优先用项目本地路径:
"executable": "node_modules/.bin/eslint"(相对路径,Sublime 会自动补全为项目根目录下的真实路径) - macOS/Linux 绝对路径示例:
"executable": "/Users/you/project/node_modules/.bin/eslint" - Windows 注意:别填
eslint.cmd,填eslint即可(插件会自动适配) - 验证方式:打开 Sublime 控制台(
Ctrl+`),输入import os; print(os.environ.get('PATH')),看输出是否包含你which eslint的目录
lint_mode 设成 ["on_save", "on_modified"] 才真正实用
默认 lint_mode 是 ["on_load", "on_modified"],每敲一个字都调一次 eslint 进程,大型文件或启用 typescript-eslint 时极易卡顿甚至假死。
- 设为
"lint_mode": ["on_save", "on_modified"]:编辑时不全量跑,只在保存瞬间完整检查一次,on_modified仅用于快速提示(如未闭合括号) - 加
"delay": 0.5防止连打触发子进程堆积 - 别用
"save"或"load_save"模式——它们依赖文件是否“已保存”,新建未存盘的.js文件或粘贴代码后常不触发 - 若项目用
eslint.config.js(ESLint v8.50+ 新格式),必须显式指定:"args": ["--config", "${project}/eslint.config.js"]
支持 TypeScript/Vue 需手动扩展 --ext 参数
默认 eslint 只查 .js 和 .jsx,.ts、.tsx、.vue 文件必须显式声明,否则静默跳过。
- 在
SublimeLinter设置中加入:"args": ["--ext", ".js,.jsx,.ts,.tsx,.vue"] - 注意逗号不能有空格,
".js, .jsx"会失效 - Vue 文件还需确保已安装
@vue/eslint-plugin和对应 parser,否则报Definition for rule 'vue/xxx' was not found - TS 文件若报
Failed to load config "eslint:recommended",大概率是typescript-eslint版本与 ESLint 不兼容,建议锁定eslint@8.57.0+@typescript-eslint/parser@6.21.0
最易被忽略的是:Sublime 启动方式。macOS 双击图标启动时,它读不到 shell 的 PATH;必须用终端执行 subl . 打开项目,才能继承当前 shell 环境——这点在团队配置文档里几乎从不提,但却是多人协作时 lint 失效的高频原因。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










