sublime text 语法检查需外部 cli 工具（如 eslint、flake8）与对应 sublimelinter 子插件（如 sublimelinter-eslint、sublimelinter-flake8）配合，缺一不可；配置错误或环境链断裂会导致静默失效。
Sublime Text 本身不带语法检查能力，所有“实时纠错”都依赖外部 CLI 工具 + 对应的 SublimeLinter 子插件组合。装错一环，比如只装插件不装 CLI、路径配错、或文件没被正确识别为对应语言，就会完全静默——既不报错也不标红。
哪些语言能用，对应什么插件和 CLI 工具
不是所有语言都有活跃维护的 linter 插件，下面这些是当前（2026 年）稳定可用、社区反馈良好的组合：
-
JavaScript/TypeScript：必须装SublimeLinter-eslint+ 系统级或项目级eslintCLI（推荐用node_modules/.bin/eslint路径） -
Python：主流选SublimeLinter-flake8（轻快）或SublimeLinter-pylint（更重但规则全），对应 CLI 是flake8或pylint -
CSS/SCSS/LESS：用SublimeLinter-stylelint+stylelintCLI；csslint已基本停更，不建议 -
Shell/Bash：SublimeLinter-shellcheck+shellcheck（macOS/Linux 原生支持好，Windows 需 WSL 或手动装） -
HTML：SublimeLinter-html-tidy+tidy，但注意它只校验结构合法性，不查语义或可访问性
像 Ruby、Go、Rust 等也有对应插件（如 SublimeLinter-rubocop），但安装后需确认 CLI 是否在 PATH 或显式配置 executable，否则照样不工作。
为什么装了插件却没任何波浪线
这是最常卡住的地方。SublimeLinter 不会主动报错，而是直接跳过——你看到“没反应”，其实是某条链断了。按顺序排查：
- 打开控制台（
Ctrl+`或Cmd+`），输入sublime.log_commands(True)，再保存一个 JS 文件，看输出里有没有类似running eslint --version的日志；没有就说明根本没触发 - 右下角状态栏看当前语法是否为
JavaScript（不是Plain text或JSON）；Python 文件同理，得是Python语法，不是Plain text - 终端里运行
eslint --version（或对应 CLI），如果报command not found，那 Sublime 肯定找不到——Windows 用户尤其注意npm install -g eslint后的eslint.cmd不在系统 PATH 里 - 项目根目录下有没有
.eslintrc.js或package.json里含eslintConfig字段？没有的话 ESLint 用空配置，几乎不报错
如何让“实时”真正响应快又不卡顿
所谓“实时”其实是延迟触发，不是每敲一个字符都跑一遍 lint。关键在 lint_mode 和语言特性匹配：
- 对
Python：可以放心开"on_modified": true，因为flake8极快，延迟设100毫秒也无压力 - 对
JavaScript：别全局开on_modified，尤其项目用了eslint-plugin-react或typescript-eslint，CPU 会明显拉高；改用"lint_mode": "background"+"delay": 0.3（单位秒）更稳妥 - 大型项目建议加
"lint_mode": ["on_load", "on_save"]保底，避免编辑时误伤性能；再为特定语言单独覆盖，比如只对source.js开 background -
args里加--quiet可过滤 warning，只留 error；加--fix可保存时自动修复（但仅限安全规则，如引号、分号）
项目级配置为什么总不生效
SublimeLinter 的配置优先级是：项目 .sublimelinterrc > 用户 Settings > 插件默认值。但项目配置极易因命名或结构错误而静默 fallback：
- 文件名必须是
.sublimelinterrc（纯 JSON 格式），写成.sublimelinterrc.json就无效 -
disable字段必须嵌套在具体 linter 下，例如："eslint": { "disable": true }，而不是顶层写"disable": true - 如果项目同时有
.eslintrc.js和 Sublime 设置里的args: ["--config ./my.eslintrc"]，后者会强制覆盖前者，导致extends链断裂 - 路径问题：Sublime 启动方式影响环境变量读取。macOS/Linux 用双击图标启动时，nvm 切换的 Node 版本不可见；应改用终端执行
subl .启动
最隐蔽的坑是：SublimeLinter 不报错，只是安静地用上一级配置。调试时务必先看控制台日志，再确认当前文件是否被正确识别为对应语言，最后才动配置文件。
