Atom主题必须分UI Theme和Syntax Theme安装启用，缺一不可；直接拖ZIP或手动解压到packages无效；需在Settings→Themes中分别选择；网络不通、旧主题不兼容、styles.less冲突、Tree-sitter解析器导致scope变化等均会导致失效。
Atom 的主题必须拆成 UI Theme 和 Syntax Theme 两部分分别安装、分别启用，缺一不可；直接拖 ZIP 或手动解压到 ~/.atom/packages 基本无效，还会导致加载失败或样式错乱。
UI Theme 和 Syntax Theme 必须分开装、分开选
很多人装完主题发现“界面没变”或“代码颜色还是老样子”，根本原因是只改了其中一类。Atom 把界面外壳（标签栏、侧边栏、按钮）和代码区域（关键字、字符串、注释）的样式完全隔离：
-
UI Theme控制.tab-bar、.tree-view、.status-bar这些 DOM 元素的背景、边框、字体大小 -
Syntax Theme控制.syntax--string、.syntax--comment、.syntax--support.function等 token 的颜色与字体粗细 - 常见错误：搜
seti装了seti-syntax却没装seti-ui，结果树视图仍是默认白底；反之只装atom-material-ui，代码块却还是灰蒙蒙的 - 装完后必须进
Settings → Themes，在两个下拉菜单里**各自点选一次**——不是装完就自动启用
搜索不到主题？先确认网络和 Atom 版本兼容性
国内用户常卡在 “Loading…” 或搜索结果为空，这不是 Atom 坏了，而是请求 https://atom.io/api/packages 失败。验证方式很简单：浏览器打开 https://atom.io，打不开就说明网络不通。
- Atom 1.60+ 已弃用
apm config set registry镜像配置，临时绕过办法是命令行直装：apm install atom-material-ui atom-material-syntax - 老主题（如 2018 年发布的
one-dark-uiv2.x）在新版 Atom 上容易错位、漏样式，甚至让树视图节点全绿；优先选 star >1k、最近更新在 6 个月内 的包 - 搜
material-ui出一堆非官方分支，报Failed to load package？应输完整包名atom-material-ui - 装完不生效？检查是否启用了
sync-settings插件——它会强制覆盖你刚选的主题设置
装完主题后仍不生效？重点查这三处
点了 Install、选了下拉项、也重启了 Atom，但还是老样子？90% 是被其他配置劫持了渲染链路：
- 确认
~/.atom/styles.less里没有硬编码@import或直接覆盖了.tab、.tree-view类——它优先级高于所有主题，会静默屏蔽 UI 主题 - 某些主题（如
spacegray-light-neue-ui）依赖特定版本的 LESS 变量，若 Atom 内置的样式编译器版本太低，会导致 CSS 规则未注入 - Mac 用户注意：系统深色模式 +
"core:use-tree-sitter-parsers": true开启时，部分 Syntax Theme 的 scope 匹配逻辑会失效，表现为 JSX 属性不着色、正则表达式变灰 - 终端（如
term3）不会自动继承 Syntax Theme 颜色，必须在styles.less中显式定义--terminal-background等 CSS 变量，并开启插件的Use CSS Variables选项
微调颜色或修复违和感？直接改 styles.less
不用重装主题、不用改 packages/xxx/styles/ 下的源文件——那些升级就丢。Atom 启动时总会加载用户级 ~/.atom/styles.less，它是定制的最终防线：
- 快捷打开：
Ctrl + Shift + P→ 输入Open Your Stylesheet回车 - 调淡注释：
.syntax--comment { color: #5c6370 !important; } - 改树视图背景：
.tree-view { background-color: #2a2e34; } - 修复 terminal 颜色割裂：先查当前主题是否导出
--terminal-foreground变量（看packages/one-dark-ui/styles/ui-variables.less），再在styles.less里补全定义 - 别用
!important盲目覆盖一切——它能解决颜色问题，但可能破坏主题自带的响应式缩放或暗色适配逻辑
最常被忽略的一点：Syntax Theme 的 scope 名称和 Atom 内部解析器强绑定。比如 notepad-plus-syntax 里写的 support.function，在 Tree-sitter 解析器启用后实际 scope 可能变成 support.function.dom.js；想精准覆盖，得先按 Ctrl+Shift+P → Developer: Inspect Editor Tokens and Scopes 看真实输出，而不是照搬旧文档里的 scope 名。
