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 的设计逻辑，不能靠“猜”，必须显式配置：
- 按
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 脚本看待。
