语法高亮异常源于grammar未加载、scope未匹配或主题覆盖颜色；文件全灰说明未识别语言，需保存为正确后缀或手动选择grammar，并确认安装对应插件及更新规则版本。
语法高亮异常不是 Atom 坏了，而是 grammar 没接上、scope 没匹配、或主题压住了颜色——三者缺一不可。
为什么文件全是灰色，连关键字都不着色？
这是最基础的识别失败，根本没进入高亮流程。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），执行Editor: Log Cursor Scope，把光标停在代码行里看控制台输出；如果首项是text.plain或source.ass这类泛化 scope，说明 Atom 完全没当它是目标语言 - 新建文件默认就是
text.plain，必须先保存为正确后缀（如.vue、.nginx、.scss）才能触发 grammar 自动加载 - 右下角状态栏显示 “Plain Text” 或 “Nginx” 而不是你预期的语言名？点它手动选一次 grammar，再检查是否装了对应插件（比如
language-vue、language-nginx、language-sass）
高亮部分失效，比如 ?. 、?? 或 export * as ns 标红？
不是插件不支持，是 grammar 规则版本跟不上语法演进。
-
?.和??在旧版language-babel（ -
export * as ns是 ES2020 新语法，当前主流 grammar 包尚未覆盖 → 可临时在config.cson中加grammarOverride强制指定 scope，但更稳妥的做法是等插件更新 -
import.meta.url被标黄？这是 Atom 自带 JavaScript grammar 的限制，language-babel不接管该 token，不影响运行，无需处理
颜色太淡、看不见、或者全灰一片？
语法主题和 grammar 是两层，只改 theme 不管用，得对准作用域链写 CSS。
- 打开
~/.atom/styles.less，加这段（适配深色背景）：.syntax--source.syntax--js .syntax--entity.syntax--name.syntax--function { color: #4FC3F7 !important; }注意：每个.syntax--xxx都不能少，否则不生效 - 别碰
@syntax-color-function变量——Tree-sitter 启用后，作用域名变了（如support.function.std.rust），变量继承会断掉 - 想快速验证是不是颜色问题？临时切到
atom-light-ui主题，如果立刻多彩了，就坐实是 styles.less 或主题冲突
Vue 文件里 <style lang="scss"> 中的 $color 不高亮？
language-sass 默认不处理 .vue 里的内联块，需要显式映射 scope。
- 装好
language-sass后，在config.cson的customFileTypes下追加："source.css.scss": ["lang=\"scss\""]
- 确保
language-vue已启用且接管了.vue文件；若右下角显示text.html.vue，说明它被当 HTML 解析，SCSS 块不会走language-sass流程 - 别装
language-vue-component这类老插件——它未正确定义source.vuescope，导致标识符提取失败，高亮直接挂掉
真正容易被忽略的是：高亮永远只作用于当前打开的文件标签页，不跨文件、不进未加载的项目文件；它不解析 AST，也不校验语法，只是基于正则和 scope 的静态染色。一旦看到标红，先查 scope 链，再查 grammar 版本，最后调色——顺序错了，花半天改 styles.less 也没用。
