Sublime Text 需通过 SublimeLinter 插件配合 eslint、flake8 等 CLI 工具实现语法检查；须安装核心插件与语言子插件，并确保系统 PATH 可调用对应 linter，否则需在设置中显式配置 paths 路径。

Sublime Text 本身不带实时语法错误检查，必须靠插件实现；最稳定、通用的方案是用 SublimeLinter 配合对应语言的 linter（如 eslint、pylint、flake8）。

安装 SublimeLinter 和语言专用 linter

先装核心插件 SublimeLinter，再装具体语言支持——注意：只装 SublimeLinter 不会报错，但不会有任何提示，必须额外安装 SublimeLinter-xxx 子插件。

• 用 Package Control → Install Package 依次安装：SublimeLinter、SublimeLinter-contrib-eslint（JS）、SublimeLinter-flake8（Python）等
• 确保系统已全局安装对应 CLI 工具：比如 eslint 要能从终端直接运行 eslint --version，否则插件找不到可执行文件
• 如果用 nvm 或 pyenv，Sublime 可能读不到 shell 的 PATH，需在 SublimeLinter.sublime-settings 中显式配置 paths，例如：

  {
    "paths": {
      "linux": [],
      "osx": ["/Users/yourname/.nvm/versions/node/v18.17.0/bin"],
      "windows": []
    }
  }

启用并验证 linting 是否生效

默认安装后是开启状态，但容易因配置或环境问题静默失败。验证方法很直接：

windows-shell-syntax

在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……

下载

• 打开一个有明显错误的文件（比如 JS 中写 consol.log('x')）
• 保存文件（部分 linter 默认仅在保存时触发），看左下角是否出现 1 error 提示
• 把光标移到报错行，看是否有黄色波浪线；按 Ctrl+Shift+P 输入 SublimeLinter: Show all errors 查看完整列表
• 如果没反应，打开 Tools → SublimeLinter → Toggle Debug，再保存一次，看控制台输出是否报 linter failed to execute 或 can't find eslint

常见失效原因和绕过方式

不是插件没装好，而是环境链路断了。重点排查这三处：

• SublimeLinter 设置里 "lint_mode": "background" 必须开启（默认是），否则只在保存/聚焦时检查，不是“实时”
• 项目根目录存在 .eslintrc.js 或 pyproject.toml 等配置文件，但内容有语法错误，会导致整个 linter 退出——可临时重命名配置文件测试
• 使用了 pnpm/yarn v4+ 的 Plug'n'Play（PnP），eslint 找不到依赖，此时需改用 eslint --no-warn-legacy-bundlers 或切换回 npm

真正卡住的点往往不在 Sublime 设置，而在 CLI 工具能否被正确调用、配置文件是否合法、以及当前工作目录是否被 linter 正确识别为项目根。调试时优先看 Sublime 控制台（Ctrl+`）里的 SublimeLinter 日志，比反复重装插件有效得多。