Sublime Text 需通过 SublimeLinter 和 SublimeLinter-eslint 插件集成 ESLint，核心是确保 eslint 可执行文件路径正确、项目有有效配置文件（如 .eslintrc.cjs），且文件后缀与语法设置匹配。
Sublime Text 本身不内置 ESLint 支持，必须通过插件桥接；核心是让 SublimeLinter 正确调用本地项目或全局安装的 eslint 可执行文件，并确保配置能被识别。
确认 ESLint 已正确安装并可命令行调用
这是最容易卡住的一步。SublimeLinter 不会帮你装 ESLint，它只负责调用。如果 eslint --version 在终端报错或提示 command not found，后续全白搭。
- 优先使用项目级安装：
npm install eslint --save-dev
，然后确保你从项目根目录启动 Sublime（subl .），这样 SublimeLinter 能自动定位node_modules/.bin/eslint - 若依赖全局 ESLint（
npm install -g eslint），需在 SublimeLinter 配置中显式指定路径，例如 macOS 上可能是/usr/local/bin/eslint，Linux 常为/home/username/.nvm/versions/node/v18.17.0/bin/eslint，Windows 则类似C:\Users\Name\AppData\Roaming\npm\eslint.cmd - 运行
which eslint（macOS/Linux）或where eslint（Windows）确认真实路径，别猜
安装 SublimeLinter 和 SublimeLinter-eslint 插件
两个插件缺一不可：SublimeLinter 是通用框架，SublimeLinter-eslint 是它的 ESLint 适配器。
- 用 Package Control 安装：
Ctrl+Shift+P→ 输入Package Control: Install Package→ 分别搜并安装SublimeLinter和SublimeLinter-eslint - 安装后重启 Sublime，否则插件不生效
- 检查是否启用：打开
Preferences → Package Settings → SublimeLinter → Settings，确认"enabled": true且"linters"下有"eslint"条目
配置 ESLint 路径与规则加载方式
默认情况下，SublimeLinter-eslint 会尝试按顺序查找：项目 node_modules → 用户 node_modules → 全局 eslint。但路径错误或规则未加载会导致“no lint results”或“cannot find module”错误。
立即学习“Java免费学习笔记（深入）”；
- 在
Preferences → Package Settings → SublimeLinter → Settings中，添加明确路径（尤其当全局安装时）：{ "linters": { "eslint": { "executable": ["/usr/local/bin/eslint"] } } } - 确保项目根目录有有效的 ESLint 配置文件：优先级为
.eslintrc.cjs>.eslintrc.js>.eslintrc.json>package.json中的eslintConfig字段 - 如果用 TypeScript，需额外安装
@typescript-eslint/parser和对应插件，并在.eslintrc.cjs中正确声明parser和plugins，否则会报Cannot read property 'name' of undefined类错误
验证实时检查是否生效及常见失效原因
保存文件或输入代码时，错误应立刻以波浪线下划线形式出现在编辑器中，光标悬停可看提示。不生效？先看这几点：
- 文件必须保存为
.js、.jsx、.ts或.tsx后缀，且右下角状态栏显示对应语法（如 “JavaScript (Babel)” 会干扰，应设为 “JavaScript”） - 检查 Sublime 控制台（
Ctrl+`）是否有报错，常见如ESLint not found、Failed to load config或Cannot find module 'eslint-plugin-react' - 如果项目用了 pnpm 或 yarn pnp，
node_modules结构不同，SublimeLinter-eslint 可能找不到依赖；此时建议改用eslint --init初始化配置，并确保所有插件都通过pnpm add -D安装到项目本地 - 实时检查默认是 on-type，但某些旧版插件或高 CPU 场景下会降级为 on-save；可在 SublimeLinter 设置中确认
"lint_mode": "background"
路径、配置文件位置、Node 模块解析逻辑——这三个点任一出错都会导致“看着装好了却没反应”。调试时别跳步，从终端能否跑通 eslint . 开始，一层层往上对齐环境。
