Sublime Text 需通过 SublimeLinter 框架+对应语言 linter 插件（如 SublimeLinter-eslint）实现语法检查，且必须预先全局安装 CLI 工具（如 eslint、pylint），并正确配置可执行文件路径；否则将出现“linter not found”或静默失效。

Sublime Text 本身不带语法检查功能，必须通过插件实现；最常用、维护活跃的是 SublimeLinter 框架 + 对应语言的 linter（如 eslint、pylint、shellcheck）。

安装 SublimeLinter 和对应语言 linter 插件

不能只装 SublimeLinter 就完事——它只是调度器，真正做检查的是外部命令行工具（比如你写 Python，得先装好 pylint 或 flake8），再装 Sublime 的适配插件。

• 用 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入 Package Control: Install Package 回车
• 搜索并安装：SublimeLinter（核心框架）
• 再分别安装对应语言的子插件，例如：SublimeLinter-pylint、SublimeLinter-eslint、SublimeLinter-shellcheck
• 确保系统已全局安装对应 CLI 工具：比如 npm install -g eslint、pip install pylint，否则插件会报 "linter not found"

配置 linter 路径和启用状态

如果 CLI 工具不在系统 PATH 中（常见于 macOS 使用 Homebrew 安装、或 Windows 使用 nvm 管理 Node 版本），SublimeLinter 找不到可执行文件，就会静默失效。

• 打开 Preferences → Package Settings → SublimeLinter → Settings
• 在右侧面板（用户设置）中添加路径映射，例如：

{
    "linters": {
        "eslint": {
            "executable": ["/opt/homebrew/bin/eslint"]
        },
        "pylint": {
            "executable": ["/usr/local/bin/pylint"]
        }
    }
}

• 也可用 "disable": true 临时关闭某 linter，避免干扰
• 检查是否启用：打开一个文件后，状态栏左下角应显示当前激活的 linter 名称（如 ESLint）

常见错误现象与排查方向

装完没反应？标红但提示不准确？大概率不是插件问题，而是环境链路断了。

• 状态栏无 linter 名称 → SublimeLinter 未启用，或文件类型未被识别（检查右下角语法模式是否为 Python、JavaScript 等）
• 报错 "command not found: eslint" → CLI 工具未安装，或路径不对；在终端运行 which eslint 确认真实路径
• 检查生效但只标红不显示具体错误 → 子插件未装（如装了 SublimeLinter 却漏装 SublimeLinter-eslint）
• 保存后才检查？默认是实时检查（on-save 可关，但不建议）；若延迟明显，可能是项目 node_modules 太大，考虑在项目根目录加 .sublimelinterrc 限制范围

最关键的其实是 CLI 工具本身的配置文件（如 .eslintrc.js、.pylintrc）是否生效——SublimeLinter 只是把它们原样传给底层命令，它不参与规则解析。