atom默认不开启语法高亮，因未识别语言；需language插件解析文件+syntax theme渲染颜色，新建untitled文件恒为text.plain，右下角显示plain text即插件缺失或未启用，用editor: log cursor scope查作用域链确认识别状态。

Atom 默认不开启语法高亮——不是坏了，是压根没识别出你在写什么语言。语法高亮必须由两部分协同：正确的 language-* 插件识别文件结构，再配合一个启用的 Syntax Theme 渲染颜色。

为什么新文件全是灰色？

新建未保存的文件（untitled）永远是 text.plain，Atom 拒绝猜测语言。它不会自动把 .js 当 JavaScript，也不会把 nginx.conf 当 Nginx 配置——除非你装了对应插件并确保其生效。

• 右下角状态栏显示 Plain Text → 说明 language 插件缺失、未启用，或后缀没被匹配
• 已保存为 .py 却仍是灰字 → 检查是否装了 language-python 并处于 Enabled 状态
• 打开 .vue 显示 text.html.vue 而非 source.vue → language-vue 或 language-vue-component 未接管 scope

怎么确认语法真被识别了？

别猜，直接看 Atom 给出的作用域链。光标停在任意代码上（比如一个函数名），按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行 Editor: Log Cursor Scope。

Humtap

Humtap是一款通过哼唱、人声和节奏输入生成原创音乐的移动端 AI 音乐创作工具。

下载

• 正常输出类似：source.js entity.name.function.js → JavaScript 语法已生效
• 只看到：text.plain 或 source.ass（但你在写 Vue）→ language 插件没起作用
• 首行是 source.vue 但后续没有 entity.name.tag → theme 不支持该 scope，需换 syntax theme 或补 CSS

Syntax Theme 必须手动启用

装了 atom-material-syntax 包 ≠ 自动生效。Atom 把界面主题（UI Theme）和代码配色（Syntax Theme）完全分开管理，只改 UI 不影响代码颜色。

• 进 Settings → Themes，找到并列的两个下拉框：UI Theme 和 Syntax Theme
• 在 Syntax Theme 下拉菜单里选一个（如 one-dark-syntax、atom-material-syntax），点一下即刻生效
• 常见错误：只在 Packages → Install 页搜到并安装了主题包，却没回 Themes 页手动选中它
• 注意：带 -ui 后缀的包（如 atom-material-ui）只改侧边栏/按钮，对代码颜色零影响

特殊文件类型要额外配 grammar 映射

像 nginx.conf、.env、.toml 这类非主流后缀，Atom 默认不认识，得靠插件 + 手动映射双保险。

• 先装对应插件：language-nginx、language-env、language-toml
• 再检查 config.cson 是否有冲突规则，例如："*.conf": "source.ini" 会强制所有 .conf 当 INI 处理，覆盖 language-nginx
• 某些插件依赖 customFileTypes 才能注入 Vue 块内语法（如 <style lang="scss"></style>），需在 config.cson 中加：

  customFileTypes:
    "source.css.scss": [
      "scss"
    ]

最常被忽略的是：语法高亮不是“开关”，而是一条链——文件后缀 → language 插件注册的 fileTypes → Atom 分配正确 scopeName → Syntax Theme 的 CSS 选择器命中该 scope。断掉任何一环，颜色就消失，且不会报错，只会静默变灰。