sublimelinter 不自动工作，依赖系统已安装且路径正确的 eslint/pylint/flake8 等命令行工具；需确保 package control 正常、主插件已装、linter 全局可执行，三者缺一不可。
SublimeLinter 不会自动工作，它只负责调度——真正干活的是你系统里装的 eslint、pylint 或 flake8 这类命令行工具；如果它们没装、路径不对、或 Sublime 没认出当前文件是 Python/JS，那插件就完全静音。
SublimeLinter 安装后没反应？先查三个硬性前提
这不是配置问题，而是基础链路断了。90% 的“没反应”都卡在这三步：
- Package Control 必须已安装且能正常调出（按
Ctrl+Shift+P能弹出面板，输入Install Package有响应） - SublimeLinter 主插件已通过 Package Control 安装（不是
SublimeLinter-eslint或SublimeLinter-pylint单独装了就行） - 对应语言的命令行 linter 已全局可执行：终端里运行
eslint --version或flake8 --version必须成功返回版本号，不能报command not found
特别注意：macOS 上用 pyenv 或 Homebrew 安装的 Python，flake8 常在 /opt/homebrew/bin 或 ~/.pyenv/shims 下，Sublime 默认不读这些路径。
为什么 pylint 装了但 Sublime 仍不标错？
因为 SublimeLinter 默认只启用已识别的语法类型 + 已安装的子插件 + 可执行的二进制路径三者同时满足时才启动检查。常见断点：
- 右下角状态栏显示的是
Plain Text而非Python—— 点击切换，或确保文件以.py结尾并已保存 - 装了
pylint，但没装SublimeLinter-pylint（仅靠主插件无法调度 pylint） -
pylint安装在虚拟环境里，而 Sublime 启动时没加载该环境变量；此时需在用户设置中显式指定路径：{ "linters": { "pylint": { "executable": "/path/to/venv/bin/pylint" } } }
别用 pip install pylint 在系统 Python 下装，再指望 Sublime 用 pyenv 的 Python 找它——路径根本对不上。
lint_mode 设成 background 还是 on_save？
选哪个取决于你写的代码类型和机器性能：
-
"lint_mode": "background"：实时检查，每敲一个字符都触发（适合小文件、本地开发、机器较新）；但对大文件或老旧笔记本可能卡顿，且部分 linter（如pylint）启动慢，会延迟高亮 -
"lint_mode": "on_save"：只在 Ctrl+S 后检查（推荐用于团队项目、含 type checking 的场景、或使用pylint时）；避免干扰输入节奏，也减少误报干扰 - 别混用多个 linter：比如同时启用
flake8和pylint，它们规则重叠、反馈冲突，SublimeLinter 不做去重，结果反而更难读
配置位置：菜单 → Preferences → Package Settings → SublimeLinter → Settings，编辑的是「User」文件，不是 Default。
路径配置写错一个斜杠就失效
SublimeLinter 对 paths 和 executable 的路径格式极其敏感，尤其在 macOS/Linux 下：
-
paths是目录列表，不是文件路径；例如flake8在/Users/me/.pyenv/shims/flake8，那paths应填"/Users/me/.pyenv/shims"，不是带flake8的完整路径 - Windows 用户注意反斜杠：
"C:\Users\me\AppData\Roaming\npm\eslint.cmd"，单个会被当成转义符 - 修改完设置必须重启 Sublime，热重载不生效
最稳的验证方式：打开 Sublime 控制台（Ctrl+`），输入 import os; print(os.environ.get('PATH'))，看输出里有没有你期望的 bin 目录——Sublime 启动时只读这一份 PATH。
