Atom代码高亮失效90%是language-*插件未正确启用或scope未匹配，需通过Editor: Log Cursor Scope确认输出如source.js等正确grammar，装完必须重启Atom，且syntax theme需手动选择并配合完整作用域链定制。
Atom 代码高亮失效，90% 是 language-* 插件没装对或没启用，不是主题问题，也不是 Atom 坏了。
怎么确认当前文件真被识别为对应语言
高亮全灰、函数名和关键字都一个颜色，说明 Atom 根本没把文件当目标语言解析。这是最核心的判断起点。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Editor: Log Cursor Scope - 把光标停在一段有效代码上（比如
console.log()或function foo()），看 DevTools 控制台第一行输出 - 正确结果应类似
source.js、source.vue、source.python；若只看到text.plain或source.ass，说明 grammar 没生效 - .vue 文件必须输出
source.vue，不是text.html.vue；.tsx 必须是source.tsx，不是source.typescript
language-* 插件装了但不生效的常见原因
装了 language-vue 却还是白屏？不是安装失败，而是没走完“注册→启用→接管”的完整链路。
- 进
Settings → Packages，搜language-vue、language-typescript-react、language-svelte等，确认状态是 Enabled（不是 Installed 就完事） - 某些插件（如
language-vue）需配合atom-ide-vue才能正确解析<script setup></script>和 TS 块，单独装前者可能漏高亮 - 装完必须重启 Atom——部分插件注册 scope 需要进程级重载，仅禁用/启用包无效
- .vue 文件若右下角显示
HTML，点击它手动选Vue Component；再检查是否仍输出text.html.vue，若是，说明language-html在劫持 scope，可临时禁用它测试
Syntax Theme 选对了颜色还是不变
装了 atom-material-syntax，也在 Settings → Themes → Syntax Theme 下拉框里选中了，但颜色还是旧的——大概率是缓存或作用域没对上。
- 右键标签页 →
Reopen File，强制刷新语法解析和样式应用 - 确保你没误装成 UI 主题：例如
atom-material-ui只改按钮和侧边栏，对代码颜色零作用；apm install后务必去 Syntax Theme 下拉框里手动点选 - Tree-sitter 语法（如
language-rust-bundled）输出的作用域名是support.function.std.rust，而老主题 CSS 选择器只认support.function，会导致匹配失败 - 深色主题下括号高亮看不见？不是功能失效，是背景色太淡——在
styles.less里加.bracket-matcher .region { background-color: rgba(100, 200, 255, 0.4) !important; }
自定义高亮时 styles.less 写法容易翻车
想调函数名颜色却没反应？不是语法错，是作用域链写漏或变量覆盖逻辑不对。
- 必须用完整作用域链写选择器：
.syntax--source.syntax--js .syntax--entity.syntax--name.syntax--function，少一个.syntax--前缀就失效 - 别直接写
color: #ff0088，应覆盖变量：@syntax-color-function: #ff0088;，否则会破坏主题继承体系 - 不要加
!important到普通 color 规则里——它会阻断后续所有变量更新；仅在.bracket-matcher .region这类底层覆盖时才需!important - 新建未保存文件默认是
text.plain，styles.less里针对source.js的规则对它完全不生效
真正卡住人的地方，往往不是“怎么装”，而是“装完要不要重启”“启用了但 scope 对不对”“theme 和 grammar 是两套独立系统”——这三个点漏掉任何一个，都会让高亮看起来像随机失效。
