Atom语法高亮需三要素协同：文件被识别为正确语言作用域（如source.xml）、语法主题定义颜色、自定义样式写在styles.less且选择器完整；缺一不可。
Atom语法高亮不是“开个开关就能炫彩”，它依赖三要素协同：文件被正确识别为对应语言（即作用域是source.xml、source.js等）、语法主题（Syntax Theme）定义了这些作用域的颜色、自定义规则必须写在~/.atom/styles.less里且选择器完整——缺一不可，否则改了也白改。
怎么确认 Atom 真把文件当目标语言解析了
高亮失效的第一信号不是颜色丑，而是全灰无色。这说明文件没被赋予正确的语法作用域。
- 把光标停在任意标签或关键字上（比如
<root></root>或function），按Ctrl+Shift+P执行Editor: Log Cursor Scope - 看 DevTools 控制台输出的最末一级 scope：
source.xml、source.js、source.vue才对；若只看到text.plain、text.html或source.ass，说明 language 插件没生效或被覆盖 - 新建未保存文件永远是
text.plain，必须先保存为.xml、.vue等后缀，或手动点击右下角状态栏切换语法
自定义颜色为什么写了没反应
根本原因是选择器不完整或优先级不够。Atom 的语法着色基于嵌套作用域链，漏一个环节就断掉。
- 别写
.syntax--string这种泛化类，要写完整链：.syntax--source.syntax--js .syntax--string.syntax--quoted.syntax--double - 所有自定义样式必须加
!important，否则会被语法主题里的 LESS 变量覆盖 - 改完保存即可生效，不用重启 Atom；但已有标签页不会刷新，新开一个才可见效果
- 常见无效写法：
atom-text-editor::shadow .string（过时 Shadow DOM 写法）、.editor .string（没带syntax--前缀）、.comment（没加syntax--且没挂载到source上下文）
如何添加新语言的自定义语法高亮（如 protobuf）
Atom 不支持“拖入一个文件就自动高亮”，必须手动创建 grammar 包并注册作用域。核心是scopeName和fileTypes匹配。
- 在
~/.atom/packages下新建目录，如language-protobuf，内建package.json声明"name": "language-proto"和"engines" - 在
grammars/子目录下建protobuf.cson，关键字段必须包含：'scopeName': 'source.protobuf'、'fileTypes': ['proto']、'patterns'数组 -
patterns里每个match是正则（注意 CSON 转义要双反斜杠，如'\bint32\b'），name必须是source.protobuf下可继承的作用域名，如storage.type.protobuf - 写完后重启 Atom，打开
test.proto，用Editor: Log Cursor Scope验证首行是否为source.protobuf
为什么改了config.cson的core.fileTypes还是不生效
这个配置只影响“新建文件”（untitled）的默认语法，且 scope 名必须精确匹配 language 插件注册的值，错一个字母就静默失败。
- 配置位置必须是
~/.atom/config.cson，不能写在styles.less或插件设置页 - 写法示例：
core: fileTypes: '.proto': 'source.protobuf'，其中source.protobuf必须与你写的 grammar 文件中scopeName完全一致 - 查准确 scope 名的方法：打开一个已高亮的
.proto文件 →Editor: Log Cursor Scope→ 看第一行输出 - 如果插件本身没启用（Packages 页面里是灰色），
fileTypes映射会完全失效，状态栏仍显示Plain Text
最易被忽略的点：语法主题（Syntax Theme）和 language 插件是解耦的。装了language-protobuf但没选one-dark-syntax这类主题，照样全灰；反过来，主题再炫，没有对应 grammar 输出作用域，CSS 选择器也无处可挂。
