必须分别启用UI Theme和Syntax Theme，二者完全解耦：UI Theme控制界面元素，Syntax Theme决定代码颜色；装错类型（如混淆-ui与-syntax后缀）、终端启动未加载新包、未用atom-text-editor::shadow穿透Shadow DOM、或未同步调整语法类颜色，均会导致主题失效。
换主题不是点一下就完事——UI Theme 和 Syntax Theme 必须分别启用，否则代码颜色根本不会变。
为什么装了主题却没效果？
常见错误是只在 Settings → Install 里搜着装了，但没去 Settings → Themes 页面手动选中。Atom 的主题分两层：UI Theme 控制侧边栏、标签页、状态栏这些界面元素；Syntax Theme 才管代码里的关键字、字符串、注释怎么上色。两者完全解耦，缺一不可。
列表里没出现刚装的主题？检查包名是否带 -ui 或 -syntax 后缀——atom-material-ui 是 UI 主题，atom-material-syntax 才是语法主题，装错类型就不会出现在对应下拉菜单里。
装完不生效还可能因为：
- Atom 是从终端用
atom .启动的（macOS 尤其常见），它读不到最新安装的包，改用 Dock 图标启动 - 用了
sudo apm install导致权限混乱，~/.atom/packages/下文件属主变成 root，Atom 拒绝加载 - 网络卡在镜像源，搜不到主题时试试关代理或换 DNS
改背景色只写 .editor { background: #1a1a1a; } 为啥行号还是黑的？
Atom 1.0+ 使用 Shadow DOM 隔离编辑器渲染层，直接写 .editor 选择器无效。必须用 atom-text-editor::shadow 包裹，才能穿透到内部样式树。
真正要改的不止一个区域：
-
atom-text-editor::shadow .editor：控制代码内容区（含空行、折叠标记） -
atom-text-editor::shadow .line-numbers：单独控制左侧数字栏，建议设为稍亮一点的灰，否则和代码区糊成一片 -
atom-text-editor::shadow .cursor：深背景上光标容易看不见，得显式设border-color或background-color
漏掉任何一项，都会出现“背景改了但行号发黑”“光标消失”“括号匹配背景色突兀”等问题。
终端颜色和代码高亮不一致怎么办？
内置终端（如 term3 或 platformio-ide-terminal）默认不读语法主题的颜色变量，它只认根级 CSS 变量，比如 --terminal-background、--terminal-green。这两套体系是分离的，硬凑会割裂。
正确做法是在 ~/.atom/styles.less 里补全定义：
:root {
--terminal-background: #282c34;
--terminal-foreground: #abb2bf;
--terminal-red: #e06c75;
--terminal-green: #98c379;
--terminal-yellow: #e5c07b;
--terminal-blue: #61afef;
--terminal-magenta: #c678dd;
--terminal-cyan: #56b6c2;
--terminal-white: #abb2bf;
}
然后进 term3 设置页，打开 Use CSS Variables 开关。别指望靠“猜”来配终端色值——one-dark-syntax v3.0+ 已内置对应变量映射，照着抄最稳。
想调注释颜色或函数名亮度，该改哪？
优先改 ~/.atom/styles.less，别碰 packages/xxx/styles/syntax-variables.less。后者会被主题升级覆盖，白改。
语法高亮类名带 .syntax-- 前缀，例如：
-
.syntax--comment：注释文本 -
.syntax--string：字符串 -
.syntax--function：函数名 -
.syntax--keyword：关键字
加 !important 防止被语法主题的 LESS 变量覆盖，比如：
.syntax--comment {
color: #6a9955 !important;
}
改完保存，不用重启 Atom，新文件或重新打开当前文件即可看到效果。如果不确定类名，用 Ctrl+Alt+Shift+P → Window: Toggle Dev Tools，悬停元素看实际生效的选择器。
最常被忽略的是：改了背景色之后，不顺手调一下语法类的 color，结果注释变淡到看不见、字符串泛绿刺眼——这不是主题问题，是你手动改背景后没同步更新文字对比度。
