linter-flake8没反应八成缺三样：linter（steelbrain作者）、linter-flake8、linter-ui-default；必须按序安装并重启，缺一不可，否则零提示、无波浪线、命令面板搜不到linter: toggle。

linter-flake8 装了但没反应，八成是缺这三样东西

Atom 的 linter 体系是分层的，只装 linter-flake8 什么都不会发生。必须同时满足三个条件：装 linter（作者 steelbrain）、装 linter-flake8、装 linter-ui-default。少一个，编辑器就“干净得可疑”——没波浪线、命令面板搜不到 Linter: Toggle、保存后零反馈。

常见现象包括：Settings 里找不到 linter-flake8 的配置入口；右下角语法标识显示为 Plain Text；flake8 --version 在终端能跑，但在 Atom 里不触发检查。

• 装完 linter 后必须执行 Window: Reload（快捷键 Cmd+Alt+R / Ctrl+Alt+R），否则 provider 加载失败
• linter-flake8 不要选作者不明的同名包，只认官方维护版本
• linter-ui-default 是渲染层，没它，错误只存在日志里，不会标红或悬停提示

为什么保存后才报错，而不是边写边检查？

linter-flake8 默认只在文件保存时触发检查，不是实时校验。这不是 bug，是设计如此——因为 flake8 是基于完整 AST 分析的工具，对未保存的碎片化代码做分析既不准又慢。

如果你真需要“边写边提示”，得手动开启 Lint on Change（在 linter-flake8 插件设置页勾选）。但要注意：

• 开启后，每敲一个字符都调用一次 flake8，项目稍大（比如含几十个 .py 文件）就会卡顿
• 部分规则（如 F821 undefined name）在未保存状态下可能误报，因为变量定义还没写完
• 真正影响体验的是 flake8 自身耗时，不是插件问题；可临时在项目根目录加 .flake8 文件，用 ignore = E501,F401 关掉高频但低风险的规则

虚拟环境里 flake8 装了，Atom 还是找不到

Atom GUI 启动时默认读不到 shell 中激活的虚拟环境路径，所以即使你在终端里能跑 flake8 --version，Atom 里仍会报 Executable not found。

Shadows Python Sensei

Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载

解决方法只有两个可靠路径：

• 在 linter-flake8 设置页填 executablePath，值设为虚拟环境里的绝对路径，例如：/path/to/venv/bin/flake8（macOS/Linux）或 C:\path\to\venv\Scripts\flake8.exe（Windows）
• 从终端启动 Atom：atom --new-window .，这样它能继承当前 shell 的 $PATH 和环境变量
• 别依赖 $PROJECT 变量自动推导——它只在项目根目录有 .flake8 或 setup.cfg 时才生效，且不解决 executable 查找问题

flake8 报的 E/F/C 错误码到底什么意思？

错误码前缀直接对应底层工具来源，理解它才能快速判断问题性质：

• E 或 W 开头（如 E302, W292）来自 pycodestyle，全是 PEP 8 风格问题：空行数不对、缩进用空格还是 tab、行太长等
• F 开头（如 F821, F841）来自 pyflakes，是真实逻辑问题：变量未定义、定义了但没用、import 写错模块名
• C 开头（如 C901）来自 mccabe，表示函数圈复杂度超标，属于可重构信号，不是语法错误

新手最容易混淆的是 F401（imported but unused）和 E401（multiple imports on one line）——前者是逻辑冗余，后者只是风格警告；团队协作时建议保留 F 类，按需关闭 E 类中非关键项。

真正容易被忽略的点是：.flake8 配置文件必须放在项目根目录，且 Atom 不会自动 reload 它——改完配置后要手动保存任意一个 .py 文件才能生效。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！