要让Flake8在Sublime Text中生效，必须同时满足：系统可运行flake8命令、SublimeLinter已启用、SublimeLinter-flake8插件通过executable字段显式指定flake8路径；保存无提示最常见原因是插件找不到flake8可执行文件。
Sublime Text 要让 Flake8 真正起作用，必须同时满足三个条件：系统能跑 flake8 命令、SublimeLinter 框架已启用、SublimeLinter-flake8 插件知道去哪里找它——缺一不可，否则保存文件时完全没反应。
为什么保存 Python 文件没任何提示？
最常见原因是插件找不到 flake8 可执行文件。SublimeLinter-flake8 不自带 flake8，它只是调用你系统里已安装的命令。如果你在终端输入 flake8 --version 报错或提示“command not found”，那 Sublime 也必然失败。
- 检查是否真的装了：
pip install flake8（推荐在项目虚拟环境中运行） - 验证能否调用：
which flake8（macOS/Linux）或where flake8（Windows） - 如果返回空，说明没装，或装在了 Sublime 找不到的路径（比如 conda 环境但没激活、venv 没激活、PATH 没包含 Scripts 目录）
- 别信“我 pip install 过了”——得在终端里敲出版本号才算数
怎么告诉 SublimeLinter-flake8 去哪找 flake8？
不能只靠系统 PATH，尤其 Windows 和多 Python 环境下 PATH 经常不一致。必须显式指定路径，在 SublimeLinter 的用户设置里写死：
菜单栏 → Preferences → Package Settings → SublimeLinter → Settings，在右侧用户设置中添加：
{
"linters": {
"flake8": {
"executable": "/path/to/your/venv/bin/flake8"
}
}
}
- macOS/Linux 虚拟环境示例：
~/myproject/venv/bin/flake8 - macOS Homebrew Python：
/opt/homebrew/bin/flake8 - Windows 全局安装（Python 3.11）：
C:\Python311\Scripts\flake8.exe - Windows conda 环境：
C:\Users\xxx\Anaconda3\envs\myenv\Scripts\flake8.exe - 别用
paths字段配全局搜索路径——它对SublimeLinter-flake8无效，只有executable才可靠
怎么让 Flake8 在保存时自动检查？
默认是开启的，但容易被覆盖。确认两点：
- 确保
"lint_mode": "save"出现在 SublimeLinter 用户设置中（不是插件默认设置，是你的用户设置） - 检查是否误关了全局 linting：按
Ctrl+Shift+P→ 输入SublimeLinter: Toggle Linting，确认状态是 “enabled” - 文件必须是
.py后缀，且 Sublime 正确识别为 Python 语法（右下角状态栏应显示 “Python”，不是 “Plain Text”） - 如果用了 Anaconda 插件，它可能和 SublimeLinter 冲突——禁用 Anaconda 或明确关闭它的 linting：
"enable_linting": false
自定义规则（比如忽略 E501、改行长）该写在哪？
优先写在项目根目录的 .flake8 文件里，SublimeLinter-flake8 默认读取它，比改 Sublime 设置更灵活、可提交、跨编辑器通用。
示例 .flake8：
[flake8] max-line-length = 88 ignore = E203, W503, E501 exclude = __pycache__, migrations/, .git/
- 不要在 Sublime 设置里用
args写一堆参数——维护困难，且不同项目无法差异化 -
.flake8是 INI 格式，必须以[flake8]开头 - Windows 下注意路径分隔符用正斜杠
/，不是反斜杠 - 改完保存后，重新打开文件或按
Ctrl+Shift+P → SublimeLinter: Recheck刷新
最容易被忽略的是：Flake8 配置文件的加载顺序。项目级 .flake8 会覆盖用户级 ~/.config/flake8，而命令行参数又会覆盖项目配置。调试时直接在终端跑 flake8 your_file.py，看输出是否和 Sublime 里一致——不一致，八成是路径或配置文件没生效。
