必须按顺序安装配置验证：先装flake8（pip install flake8），再装SublimeLinter和SublimeLinter-flake8插件，最后配置路径并重启；任一环节缺失或顺序错误都会导致静默失效，无法显示波浪线或报错。
能用，但必须按顺序装、配、验，缺一不可；否则根本看不到任何波浪线或报错。
先装flake8，再装插件，顺序错了就失效
SublimeLinter-flake8 只是“翻译器”，真正干活的是系统里独立安装的 flake8 命令。如果终端里运行 flake8 --version 报 command not found，那 Sublime 一定不会有任何反应。
- 推荐用 pip 安装：在终端执行
pip install flake8（建议在项目虚拟环境中装，避免全局污染） - 装完立刻验证：
which flake8（macOS/Linux）或where flake8（Windows），记下路径，后面配置要用 - 不要跳过这步直接装插件——很多用户卡在这里，以为插件没装好，其实是
flake8根本没装或不在$PATH里
SublimeLinter 和 SublimeLinter-flake8 必须都装
SublimeLinter 是框架，SublimeLinter-flake8 是它的 Python 适配器，二者缺一不可。只装其中一个，linter 不会启动。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入Package Control: Install Package - 依次搜索并安装：
SublimeLinter→ 等它完成 → 再搜SublimeLinter-flake8 - 装完别急着写代码，先重启 Sublime Text（尤其 Windows 用户，常因缓存导致插件未加载）
路径不对或语法不匹配，就不会触发检查
即使插件和工具都装好了，也可能“静默失效”：没有报错，也没有波浪线。常见原因是 Sublime 没识别出这是 Python 文件，或找不到 flake8 可执行文件。
立即学习“Python免费学习笔记（深入）”；
- 确认右下角状态栏显示的是
Python（不是Plain Text），否则 linter 不会运行；可手动Ctrl+Shift+P→Set Syntax: Python - 打开
Preferences > Package Settings > SublimeLinter > Settings，在用户设置中补全flake8路径（Linux/macOS 通常不用配，Windows 必须）：
{
"linters": {
"flake8": {
"executable": "/path/to/flake8" // 用 which/where 命令查到的真实路径
}
}
}
- 如果用 pyenv、conda 或 Poetry，路径可能是
/Users/xxx/.pyenv/shims/flake8或C:/Users/xxx/anaconda3/Scripts/flake8.exe，不能写错
常见红标不是代码错，而是配置断链
看到红色波浪线但点开没提示，或报 No lint results. Linter crashed.，大概率不是代码问题，而是链路中断。
- 检查控制台输出（
View > Show Console），搜索flake8或error，常有具体路径失败提示 - 临时在终端跑一次：
flake8 test.py，看是否真能输出错误；如果终端也不报，说明flake8安装异常或配置文件（如.flake8）语法错误 - 混合缩进（Tab + 空格）会导致行号偏移，高亮错位；统一用空格缩进（
View > Indentation > Convert Indentation to Spaces） - 文件带 BOM 头也会干扰解析；用
File > Reopen with Encoding > UTF-8重载一次
最易被忽略的一点：SublimeLinter 默认只对保存后的文件做完整扫描，实时背景检查（background mode）需确保 "lint_mode": "background" 已启用，且文件未被标记为“排除语法”（比如某些模板文件被 syntax_map 过滤了）。
