Atom语法高亮依赖grammar解析结构和styles.less定义颜色，缺一不可；需确保scopeName规范、fileTypes正确配置、正则转义准确，并通过Editor: Log Cursor Scope验证作用域匹配。

Atom 的语法高亮不是靠“开个开关”就能自定义的，它依赖两层独立但协同的机制：一是 grammar（语法规则）决定哪些文本属于什么语法成分（比如哪个是函数名、哪个是注释），二是 styles.less（样式表）决定这些成分渲染成什么颜色。漏掉任一层，你看到的都是“有结构没颜色”或“有颜色没逻辑”。

怎么写一个 language-xxx 语法包

这是让 Atom 认出你的文件类型、并拆解出关键字/字符串/注释等结构的前提。不写 grammar，styles.less 再改也没用——它连“哪段是函数”都找不到。

• scopeName 必须唯一且规范，推荐用 source.xxx（如 source.ass），避免用 text.xxx（后者常用于纯文本变体，作用域继承行为不同）
• fileTypes 是数组，写成 ['ass', 'ssa']，不是 'ass, ssa'；Windows 路径分隔符不影响，但扩展名必须全小写
• patterns 里正则要双反斜杠转义：'match': '\bfunction\b'，单写 function 会报错或不匹配
• 不要在 patterns 里直接写 CSS 颜色，只写作用域名，例如 'name': 'entity.name.function.ass'，后续由主题映射颜色
• 本地开发时，把包放 ~/.atom/packages/language-ass/ 后，必须按 Ctrl+Alt+R 重载窗口，仅重启 Atom 不生效

为什么改了 styles.less 没反应

常见原因是作用域名对不上——你写的 CSS 选择器和 grammar 实际输出的作用域不匹配。Atom 不报错，只是静默忽略。

• 用 Ctrl+Shift+P → 输入 Editor: Log Cursor Scope，把光标停在想调试的代码上，看控制台输出的实际作用域链（比如 source.ass entity.name.function.ass）
• CSS 选择器必须完整包含最具体的那个作用域，例如写 .syntax--source.syntax--ass .syntax--entity.syntax--name.syntax--function，缺一不可
• 不要用 !important 强制覆盖，One Dark 等主流主题靠 @syntax-color-function 变量统一控制，硬写颜色会破坏主题一致性
• 如果用了 Tree-sitter 语法（如 language-rust-bundled），styles.less 仍有效，但作用域命名规则和 TextMate 不同，需查对应 grammar 的 scope 文档

新文件默认语言为啥还是 Plain text

因为 Atom 故意不猜。它只认 core.fileTypes 配置，其他任何方式（装插件、改 grammar、点状态栏）都不影响新建未保存文件的语言判定。

• 必须编辑 ~/.atom/config.cson（macOS/Linux）或 %USERPROFILE%.atomconfig.cson（Windows）
• 加这段：

  core:
    fileTypes:
      '.rs': 'source.rust'
      '.ass': 'source.ass'
      '.proto': 'source.protobuf'

• 改完保存，关掉所有 Atom 窗口再重开，Ctrl+N 新建的空白文件才会自动套上对应语法
• 如果已打开的 untitled 文件没变，说明它已绑定 Plain text，关掉重开即可；不存在“刷新当前文件语法”的快捷键

真正难的不是写正则或改颜色，而是搞清作用域从 grammar 输出、经 theme 变量映射、再到 CSS 渲染的整条链路。中间任意一环断掉，高亮就消失——而且 Atom 绝不会告诉你哪里断了。