Sublime Text如何配置Linter代码检查？实时纠错防Bug-sublime-PHP中文网

sublime text本身不检查语法错误，必须依赖sublimelinter框架+eslint或flake8等cli工具协同工作；常见无反应原因是sublime找不到cli工具路径（因其不继承shell path），或未安装对应子插件、未以文件夹形式打开项目。

sublime text如何配置linter代码检查？实时纠错防bug

Sublime Text 本身不检查代码，装了插件却没报错，大概率是 SublimeLinter 找不到真正的检查工具（比如 eslint 或 flake8），而不是插件没装对。

最常见原因：Sublime 启动时不读 shell 的 PATH，导致它压根找不到你终端里能跑的 eslint --version 或 flake8 --version。

macOS 用 nvm 或 pyenv 时，which eslint 返回的是类似 /Users/xxx/.nvm/versions/node/v18.17.0/bin/eslint，但 Sublime 需要的是它的父目录：/Users/xxx/.nvm/versions/node/v18.17.0/bin
Windows 用户注意填的是 eslint.cmd 所在目录（如 C:Program Files odejs），不是完整路径
只装了 SublimeLinter 主插件，没装 SublimeLinter-eslint 或 SublimeLinter-flake8 —— 这些子插件才是“翻译器”，缺一不可
文件右下角状态栏显示的是 Plain Text 而不是 JavaScript 或 Python，linter 根本不会启动

别猜，直接看日志输出：

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

打开 Tools → SublimeLinter → Toggle Debug
在 JS 文件里故意写个 consol.log(1)，保存
按 Ctrl+` 打开控制台，观察输出：
- 出现 linter failed to execute 或 can't find eslint → 路径配置错
- 出现 ESLint couldn't find a configuration file → .eslintrc.js 缺失或语法错误（比如多了一个逗号）
- 控制台完全没输出，且左下角无错误计数 → lint_mode 被关了，或子插件根本没启用

打开 Preferences → Package Settings → SublimeLinter → Settings（务必改「User」设置）：

"lint_mode" 推荐设为 ["on_save", "on_modified"]：避免每敲一个字都触发全量检查，尤其对大型 JS 文件或用了 typescript-eslint 的项目
"delay": 0.5 必加：防止快速连打触发一堆 eslint 子进程堆积

"paths" 必须显式声明：

{
  "paths": {
    "osx": ["/Users/xxx/.nvm/versions/node/v18.17.0/bin"],
    "windows": ["C:\Program Files\nodejs\"]
  }
}

语言级参数走 "linters" 块，例如让 flake8 接受 120 列宽：

"linters": {
  "flake8": {
    "args": ["--max-line-length=120"]
  }
}

SublimeLinter 只在“以文件夹形式打开项目”时，才向上查找根目录下的配置文件。双击打开单个 .js 或 .py 文件，它完全看不到 .eslintrc.js 或 .pylintrc。

必须通过 Project → Open Folder 打开整个项目目录
Python 项目用了虚拟环境，pylint 必须装在那个环境下：source venv/bin/activate && pip install pylint
.pylintrc 文件本身不能有语法错误，否则 linter 直接退出，不报错也不提示

真正容易被忽略的点是：Sublime 不继承 shell 环境变量，所以 which xxx 的结果只是起点，填进配置的是其父目录；而项目配置是否生效，取决于你是不是“打开文件夹”，不是“打开文件”。