SublimeLinter 装不上是因为插件名已更改为 SublimeLinter（无下划线），旧版 SublimeLinter_sublime 已弃用；需通过 Package Control 搜索正确名称安装，并配置对应语言的命令行 linter 及 PATH。
SublimeLinter 装不上，Package Control 里搜不到怎么办
不是插件下架了，是名字变了——现在叫 SublimeLinter（没下划线），而 SublimeLinter_sublime 是旧版、已弃用。直接搜后者，当然找不到。
- 打开
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Package Control: Install Package - 等列表加载完，搜
SublimeLinter（注意拼写和大小写），回车安装 - 装完不会立刻生效：它只是“校验框架”，还缺具体语言的 linter，比如
eslint（JS）、pyflakes（Python） - 如果提示
command not found: sublimelinter，说明没配好 PATH 或 linter 可执行文件不在系统路径里
装了 SublimeLinter，但 JS/Python 没反应
因为 SublimeLinter 默认不带任何语言检查器，它只负责调用你本地已有的命令行 linter 工具。
- JS 场景：确保本机已全局安装
eslint（npm install -g eslint），且eslint命令能在终端里直接运行 - Python 场景：推荐装
pyflakes（轻量）或flake8（更全），用pip install pyflakes即可 - 检查 SublimeLinter 设置：
Preferences → Package Settings → SublimeLinter → Settings，确认"lint_mode": "background"已启用 - 如果用 nvm 管理 Node 版本，Sublime 可能读不到 nvm 的 PATH，需在 Sublime 启动脚本里显式设置
PATH，或改用eslint的绝对路径（如/Users/xxx/.nvm/versions/node/v18.18.2/bin/eslint）
SublimeLinter 报错 linter crashed 或标红位置不准
常见于 linter 输出格式不兼容，或解析时遇到语法错误导致提前退出。
- 先在终端手动跑一遍对应命令，比如
eslint /path/to/file.js，看是否报错、输出是否为标准 JSON 格式（SublimeLinter 依赖它定位问题） - 某些 linter（如旧版
jscs）已停更，输出格式与 SublimeLinter 不兼容，必须换eslint - JSX/TS 文件需额外配置 parser：在项目根目录加
.eslintrc.js，确保parserOptions含ecmaVersion和sourceType - SublimeLinter 默认只 lint 保存后的文件；若想实时 lint，要设
"lint_mode": "background"，但会略微增加 CPU 占用
为什么有些文件类型就是不触发校验
SublimeLinter 严格按 Sublime 的 scope（语法作用域）匹配，不是“有后缀就 lint”。
- 打开一个文件，按
Cmd+Alt+P（macOS）或Ctrl+Alt+P（Win/Linux），看底部状态栏显示的 scope 名，比如source.js.react或source.python - 在
SublimeLinter.sublime-settings里检查"syntax_map"是否把当前 scope 映射到了对应 linter；默认可能没覆盖source.js.react，得手动加："source.js.react": "eslint" - 如果用的是自定义语法高亮包（比如
Babel），它的 scope 名和官方JavaScript不同，必须显式映射，否则 SublimeLinter 直接跳过 - 空文件、无扩展名、或 Sublime 未识别语法类型的文件，linter 一律不运行
最常被忽略的其实是 scope 映射和 PATH 隔离——Sublime 进程启动时继承的环境变量，和你终端里的常常不是一回事，尤其用 zsh + asdf/nvm/pyenv 时。别急着重装，先开个终端，which eslint，再进 Sublime 查 view.settings().get('syntax') 和 sublime.log_commands(True) 看它到底调了啥命令。
