Atom代码高亮必须通过apm或Settings→Install安装Syntax Theme，不可手动解压；UI Theme控制界面元素，Syntax Theme才决定代码颜色，二者独立，装错类型无效，且安装后须在Settings→Themes中手动启用Syntax Theme下拉菜单选项。
Atom 的代码高亮（Syntax Theme）必须通过 apm 安装或 Settings → Install 界面安装，**不能靠手动解压 ZIP 到 ~/.atom/packages 目录生效**——路径错、权限错、不注册 scope、不触发激活钩子，装了也白装。
怎么确认你装的是 Syntax Theme 而不是 UI Theme？
UI Theme 控制侧边栏、标签页、按钮样式；Syntax Theme 才管 if、function、注释、字符串这些代码块的颜色。两者完全独立，装错类型就等于没装。
- 正确包名通常含
-syntax后缀，比如one-dark-syntax、atom-material-syntax-dark、solarized-light-syntax - 错误例子：
one-dark-ui是 UI 主题，seti-ui也是 UI 主题，它们对代码颜色零影响 - 在 Settings → Themes 页面右侧的
Syntax Theme下拉菜单里，只会出现已成功安装且注册成功的语法主题
apm 命令安装后为啥下拉菜单里没有？
因为 apm install 只负责下载和解压，**不会自动启用**，也不会刷新主题注册表。常见于 Atom v1.60+ 或网络中断导致部分元数据未写入。
- 执行
apm install atom-material-syntax-dark后，必须手动打开 Settings → Themes → Syntax Theme，从下拉框中选中它 - 如果下拉框为空，先检查终端输出有没有
WARN deprecated或ERR!；再运行apm list --installed --themes确认是否真出现在列表里 - 仍不显示？重启 Atom —— 某些语法主题（如
language-typescript-react依赖的）需重启才能完成 scope 注册
手动改 styles.less 能替代 Syntax Theme 吗？
不能完全替代，但可做局部覆盖。Syntax Theme 提供整套语义化变量（如 @syntax-background-color），而 styles.less 是最后一层 CSS 覆盖，适合调单个元素，不适合重建整套配色逻辑。
- 想让 JS 字符串变橙色？加一行：
.syntax--string { color: #ff9800 !important; } - 但改不了括号匹配高亮、嵌套作用域透明度、或 Markdown 标题层级色差——这些由 Syntax Theme 的 LESS 变量和规则链控制
- 直接改
~/.atom/packages/one-dark-syntax/styles/syntax-variables.less会被下次更新覆盖，属于高危操作
装完 Syntax Theme 还是灰色代码？重点查这三处
90% 的“高亮不生效”问题出在 language 插件缺失或 scope 映射失败，和 Syntax Theme 本身无关。
- 打开一个 .vue 文件，按
Ctrl+Shift+P→ 输入Editor: Log Cursor Scope回车，看第一行是不是source.vue；不是就说明language-vue没装或没生效 - 检查
config.cson中fileTypes是否映射正确，例如：'.vue': 'source.vue'，注意引号和冒号空格 - 某些文件（如无扩展名的
Untitled）默认用source.gfm或text.plain，得单独映射：'': 'source.js'
最易被忽略的一点：Syntax Theme 不会自动绑定到文件类型，它只是“颜料盒”。真正决定哪段代码用哪种颜色的，是当前编辑器窗口的 grammar（即右下角显示的 “Plain Text”、“JavaScript”、“Vue Component”）。这个 grammar 由 language 插件提供，由 fileTypes 或文件扩展名触发。换主题前，先确保 grammar 显示正确。
