语法高亮不生效主因是Atom未将文件识别为对应语言，需用Ctrl+Shift+P执行Editor: Log Cursor Scope查看作用域链，若首行为text.plain或错误scope（如source.ass写Vue文件），说明language插件未生效或fileTypes映射错误；新建未保存文件默认为text.plain，须先保存后缀或手动选语法。
语法高亮不生效，90% 是 Atom 没把文件当代码解析，而不是主题或插件坏了。 直接查作用域链比换十个主题都快。
怎么确认当前文件真被识别为对应语言
全灰、无缩进、无括号匹配——这不是颜色问题，是 Atom 根本没启动语法解析。右下角状态栏显示 Plain Text 或 text.html.vue 就是铁证。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Editor: Log Cursor Scope - 把光标停在函数名、变量或关键字上（比如
console.log()或export default），看 DevTools 控制台第一行输出 - 理想结果是类似
source.js entity.name.function.js；若只看到text.plain或source.ass（但你写的是 Vue），说明 language 插件没接管 - 新建未保存文件永远是
text.plain，必须先保存为.vue或手动点击状态栏选语法
为什么装了 language-vue / language-nginx 却还是不亮
插件装了 ≠ 自动生效。Atom 依赖精确的 grammar scope 名匹配，拼错一个字母、多一个点，fileTypes 映射就静默失败。
- 查 scope 名唯一可靠方式：打开一个已正确高亮的文件 → 执行
Editor: Log Cursor Scope→ 看首行（如source.vue，不是text.html.vue） -
.vue文件应映射到source.vue（来自language-vue-component），而非旧式text.html.vue -
nginx.conf要靠language-nginx插件识别，它不依赖后缀，但会匹配路径含/nginx/或文件名含nginx的.conf；别装已停更的nginx-conf - 检查
config.cson是否有冲突映射，例如"*.conf": "source.ini"会强制所有.conf当 INI 处理，直接覆盖language-nginx
theme 和 styles.less 改了为啥还是没颜色
语法主题（syntax theme）和自定义样式（styles.less）都得对准作用域链里的 class 名，否则改了等于没改。
- 深色主题常把
.bracket-matcher .region设成接近背景的浅灰，肉眼不可见；临时切atom-light-ui验证是否颜色问题 - 给
highlight-selected调色必须用.highlight-selected类，改@syntax-color-variable完全无效 - Tree-sitter 语法包（如
language-rust-bundled）输出的作用域名是support.function.std.rust，老主题的 CSS 选择器（如.syntax--function）根本匹配不上 -
styles.less中所有规则必须加!important，否则被主题 CSS 层叠覆盖
最容易被忽略的是：作用域链里出现 meta.embedded 或 source.gfm 这类嵌套 scope 时，高亮逻辑可能被截断——比如 Markdown 里的代码块，需 language-gfm + language-javascript 双重生效，缺一不可。
