Atom Shell语法高亮失效主因是文件未被识别为source.shell，需确认右下角显示Shell Script、光标作用域为source.shell或source.bash，并确保language-shellscript启用且无config冲突。

Atom 脚本语法高亮不生效，90% 是因为文件没被识别为对应语言，而不是主题或插件没装对；必须确保右下角显示 source.shell（而非 Plain Text 或 text.html），否则所有高亮、格式化、运行功能全失效。

怎么确认 Atom 正确识别了 Shell 脚本

语法高亮“全灰”不是颜色问题，是识别失败的明确信号。先验证作用域：

• 打开一个 .sh 文件（或任意脚本文件）
• 把光标停在 #!/bin/bash 或 echo "hello" 上
• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行 Editor: Log Cursor Scope
• 看 DevTools 控制台第一行输出：如果是 source.shell 或 source.bash，说明识别成功；若只看到 text.plain 或 source.ass，说明 language 包未生效或后缀未绑定

language-shellscript 必须启用且不被覆盖

language-shellscript 是 Atom 官方维护的 Shell 语法包，但默认可能被禁用或压制：

• 进 Settings → Packages，搜索 language-shellscript，确认状态为 Enabled（蓝色），不是灰色禁用
• 检查 ~/.atom/config.cson 是否有冲突映射，比如："*.sh": "text.html" —— 这类规则会直接劫持后缀，删掉
• 新建未保存文件永远是 text.plain，必须先保存为 .sh 后缀，或手动点击右下角语言名 → 选 Shell Script
• 如果文件无后缀（如 deploy），右下角点语言名后搜 Shell，选 Shell Script 即可临时生效

一键让新文件默认用 Shell 语法

新建文件默认为 Plain Text 是 Atom 的设计逻辑，不能靠“猜”，必须显式配置：

MagicForm

MagicForm是一款用于创建智能表单、线索问答和销售资格筛选的 AI 表单工具。

下载

• 按 Ctrl+Shift+P 输入 Open Your Config，打开 config.cson
• 在 core: 下添加 fileTypes: 映射，例如：

core:
  fileTypes:
    '.sh': 'source.shell'
    '.bash': 'source.bash'
    '': 'source.shell'

• ''（空字符串）代表无扩展名的新建文件，统一用 Shell 语法；source.shell 是 language-shellscript 注册的准确 scope 名，不能写成 shell 或 bash-script
• 改完保存，**不用重启 Atom**，但已有 untitled 标签页不会变，新开一个才生效
• 如果 .sh 文件仍被识别为 HTML，大概率是装了 language-html 并启用了 “Auto-detect” 类功能，关掉它

为什么改了 config.cson 还是不亮？常见静默失效点

配置写对了，但高亮依然无效，往往卡在这些容易被忽略的环节：

• language-shellscript 插件被其他插件（如 grammar-selector）强制覆盖，检查是否启用了 “Force Grammar” 功能
• 文件编码不是 UTF-8：进 Config → Core → File Encoding，设为 UTF-8，否则含中文注释时整个文件可能降级为 text.plain
• 用了 Tree-sitter 解析器（如启用了 Use Tree Sitter Parsers），但 language-shellscript 当前版本未完全适配，临时关闭 Tree Sitter 测试是否恢复
• 主题不支持 source.shell 下的细分作用域（如 support.function.builtin.shell），可临时换用 one-dark-syntax 验证是否主题层缺失

最常被跳过的一步是：没确认 Editor: Log Cursor Scope 输出的作用域链。只要第一行不是 source.shell 或其变体，后面所有美化、运行、调试都只是徒劳——Atom 从源头就没把它当 Shell 脚本看待。