Atom不报语法错误是因为linter插件链未正确安装或配置：必须先装linter核心包，再装linter-eslint；文件需被正确识别为对应语言；项目需有.eslintrc.*或package.json配置；拼写检查需配置scopeBlacklist避免误标中文注释。
Atom 本身不报语法错误，所有红色波浪线和错误提示都来自插件链——没装对、没配好、或被其他插件干扰，就会“该标不标”或“乱标一气”。
为什么改了代码还是没红波浪线？
根本不是 Atom 没反应，而是 linter 插件压根没启动。常见断点：
-
linter核心包没装（只装了linter-eslint会静默失败） - 文件右下角显示
Plain Text，说明 Atom 没识别成目标语言，linter-eslint不会触发 -
linter设置页里Lint on Change和Lint on Save全部关闭 - 项目根目录没有
.eslintrc.*或package.json里没配eslintConfig，ESLint 默认不加载规则，直接跳过检查
红色波浪线标错位置或标在不该标的地方？
这不是误报，是作用域解析出问题。尤其在混合内容（如 JSX、TSX、带模板字符串的 JS）中常见：
- 没配
@typescript-eslint/parser，TS/JSX 文件被当成纯 JS 解析，interface或as const就会标红 - 字符串里写正则或 SQL，被 linter 当作代码片段去校验语法，报出
Unexpected token -
spell-check插件开着，且没配置scopeBlacklist: ["comment", "string"]，中文注释里的波浪线其实是拼写检查在报错，不是语法问题
控制台看到 Cannot read property 'getSuggestions' of undefined？
这是 autocomplete-plus 调用补全 provider 失败，和语法报错无关，但会掩盖真实 linter 输出：
- 对应语言的 provider 插件（如
atom-typescript、ide-python）没启用或加载失败 - 插件依赖的 Node 模块编译失败（常见于 macOS 更新后），运行
apm rebuild可修复 - 多个补全插件冲突（比如同时启用了
atom-ide-ui和autocomplete-plus的增强包），禁用其中一个再试
Minimap 上看不到错误标记？
不是插件没装，是信号没传过去。必须三者同时就位：
-
linter插件已启用，且检测到了错误（看底部状态栏有没有数字） -
minimap-linter设置页勾选了Show errors in minimap -
minimap设置页开启了Display Minimap，且Minimap Width≥ 100（太窄时多个错误点被压成一个）
改完任意一项后，保存当前文件才能刷新 minimap 标记——很多人漏掉这步，以为配置无效。
