Sublime如何安装ESLint插件_Sublime实时JavaScript语法检查-sublime-PHP中文网

sublime需同时安装sublimelinter和sublimelinter-eslint（全小写、带连字符），且必须本地安装eslint、项目方式打开、配置正确.eslintrc.*文件、设lint_mode为background，并手动指定executable路径以确保eslint正常运行。

sublime如何安装eslint插件_sublime实时javascript语法检查

Sublime 本身不带 ESLint 支持，装错插件名或漏装依赖框架就会全程静默——保存 JS 文件后零提示、零高亮，不是规则没配好，是 lint 根本没跑起来。

SublimeLinter 和 SublimeLinter-eslint 必须都装，且顺序不能错

只装 SublimeLinter-eslint 不起作用：它只是适配器，没有 SublimeLinter 这个主框架，连进程都不会启动。常见误装包括 SublimeLinter-ESLint（大写 ES）、eslint_sublime（已废弃），这些都不会工作。

用 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）打开命令面板
先搜 Package Control: Install Package → 安装 SublimeLinter → 等它完成并重启
再装 SublimeLinter-eslint（注意全小写、带连字符）
装完后按 Ctrl+Shift+P 输入 SublimeLinter: Toggle Linting，确认状态为 Enabled

eslint 必须本地安装，且 Sublime 要以项目方式打开

全局安装的 npm install -g eslint 在 macOS/Linux GUI 环境下大概率失效——Sublime 启动时读不到 shell 的 PATH；Windows 上还容易因 eslint.cmd 后缀识别失败而静默退出。

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

进你的 JS 项目根目录，运行 npm install eslint --save-dev
确保生成了 node_modules/.bin/eslint（可用 ls node_modules/.bin/eslint 验证）
在 Sublime 中必须通过 Project → Add Folder to Project（或终端执行 subl .）打开整个文件夹，不能只拖一个 .js 文件进来
若仍报 Couldn't find eslint executable，手动指定路径：Preferences → Package Settings → SublimeLinter → Settings，右侧加

{
  "linters": {
    "eslint": {
      "executable": ["./node_modules/.bin/eslint"]
    }
  }
}

.eslintrc.* 文件命名和位置必须严格合规

SublimeLinter-eslint 不会读 eslint.config.js（ESLint v8.50+ 新格式），也不自动识别 package.json 里的 eslintConfig 字段——只认标准配置文件名，且只从当前文件所在路径向上查找，遇到 node_modules 就停。

支持的文件名（大小写敏感）：.eslintrc.js、.eslintrc.cjs、.eslintrc.json、.eslintrc.yml
必须放在项目根目录，或其任意父级目录中（但别跨过权限受限目录）
验证配置是否生效：终端进入项目根目录，运行 eslint --print-config index.js，有输出才说明被正确加载
避免用 "ecmaVersion": "latest"，改用具体数字如 2022，更稳

实时检查要设 `lint_mode` 为 `background`，别信 `save`

lint_mode: "save" 看似合理，实则陷阱多：未保存的临时标签页、语法识别失败、多标签切换时极易漏检；而 background 模式会在你每次按键后几秒内触发校验，真正接近“实时”。

Preferences → Package Settings → SublimeLinter → Settings，右侧加

{
  "lint_mode": "background"
}

右下角状态栏必须显示 JavaScript，不是 Plain Text 或 HTML；右键 → Set Syntax → JavaScript 强制指定
控制台（View → Show Console）里应能看到类似 SublimeLinter: eslint: xxx.js ERROR 的日志；没有就说明前面某步断了

最容易被忽略的是：Sublime 启动时根本不继承你的 shell 环境变量，哪怕终端里 eslint --version 能跑，Sublime 也可能完全找不到命令——所以永远优先本地安装 + 相对路径配置，别赌 PATH。