Atom主题安装应通过Settings→Install搜索安装，避免手动解压；装后需在Themes页分别启用UI Theme和Syntax Theme；定制样式优先编辑~/.atom/styles.less；终端配色需在styles.less中定义CSS变量并启用term3的Use CSS Variables选项。
直接装主题：Settings → Install 里搜名字就能用
Atom 主题安装本身不复杂，核心是别去手动下载 ZIP 解压到 ~/.atom/packages——容易权限错、路径错、没激活。官方渠道最稳：Ctrl + ,（Windows/Linux）或 Cmd + ,（Mac）打开设置，点左侧 Install，在搜索框输主题名，比如 one-dark-ui 或 solarized-light，点 Install 就完事。
常见错误现象：
- 搜不到主题？确认网络能访问 GitHub（Atom 插件源默认走 gitcode 镜像，但偶尔会卡在 DNS 或代理）
- 装完不生效？检查是否在 Themes 页里真正选中了它——UI Theme 和 Syntax Theme 是两个下拉菜单，必须分别选，缺一不可
- 装了
atom-material-ui却报Failed to load package？大概率是 Atom 版本太新（v1.60+），该主题已停止维护，换one-dark-ui更可靠
改颜色不用重装：编辑 styles.less 覆盖变量
想调深浅、换高亮色、改标签栏高度？根本不用动主题源码。Atom 启动时会自动加载用户级样式表 ~/.atom/styles.less，它优先级高于所有主题，是定制的“最后一层覆盖”。
实操建议：
- 快捷打开方式：
Ctrl + Shift + P→ 输入Open Your Stylesheet回车 - 改背景色？写
atom-workspace { background-color: #1a1a1a; } - 让注释更淡一点？加
.syntax--comment { color: #5c6370 !important; }（!important防止被语法主题变量覆盖） - 别直接改
packages/one-dark-syntax/styles/syntax-variables.less——下次主题升级会被覆盖，白改
终端颜色同步：靠 CSS 变量，不是靠猜
Atom 内置终端（platformio-ide-terminal 或 term3）默认不会自动套用语法主题色，必须显式绑定。它读的是根级 CSS 变量，比如 --terminal-background，而不是 LESS 变量。
为什么这样做？因为终端渲染层和编辑器语法高亮层分离，变量体系不互通。手动配错就导致终端黑底白字但代码块却发紫，视觉割裂。
- 先确认你用的是支持变量的主题（
one-dark-uiv3.0+ 和one-light-uiv3.0+ 都内置了这些变量） - 在
styles.less里补全定义（以 One Dark 为例）：:root { --terminal-background: #282c34; --terminal-foreground: #abb2bf; --terminal-red: #e06c75; --terminal-green: #98c379; } - 如果终端仍不响应，检查是否启用了
term3的Use CSS Variables选项（在它的设置页里）
自定义主题别从零建：克隆官方包改 syntax-variables.less
真要深度定制（比如公司统一配色、适配色盲模式），推荐基于官方主题二次开发，而不是新建空包。省掉结构校验、作用域兼容、变量继承这些坑。
实操路径：
- 进
~/.atom/packages，用git clone https://gitcode.com/gh_mirrors/at/one-dark-syntax.git my-company-syntax - 改
my-company-syntax/styles/syntax-variables.less里的@syntax-hue、@syntax-saturation、@syntax-brightness，三个值调完，整套高亮就偏移了色相环 -
apm link后重启 Atom，就能在 Themes 里看到你的主题名 - 注意：别改
index.less的@import路径——Atom 会按约定找styles/下的文件，路径写错就整个主题变白屏
最容易被忽略的一点：语法高亮的可访问性不只是颜色，还有亮度对比度。@syntax-text-color 和 @syntax-background-color 的差值低于 4.5:1，长时间看就会累眼，别光盯着“好看”。
