必须分别启用UI Theme和Syntax Theme：UI Theme控制界面元素（如标签页、侧边栏），Syntax Theme决定代码颜色（如关键字、字符串、注释），二者完全解耦且不可互相替代，仅启用其一将导致主题效果不完整。
UI Theme 和 Syntax Theme 必须分开启用
只装一个主题却没效果，大概率是只启用了 UI Theme（比如 one-dark-ui）而没配 Syntax Theme（比如 one-dark-syntax）。Atom 把界面外壳和代码着色完全拆开：前者管标签页、侧边栏、状态栏，后者才决定 if、"string"、注释的颜色。两者不联动，也不能互相替代。
在 Settings → Themes 页面，你会看到两个并列下拉框：UI Theme 和 Syntax Theme。必须各自点开选中，缺一不可。装错包名也常见——搜 atom-material 时，atom-material-ui 是 UI 主题，atom-material-syntax 才是语法主题，装反了就白忙活。
常见失效场景：
- 从终端执行
atom .启动，Atom 可能加载旧缓存，改用 Dock 图标或菜单启动更稳 -
sudo apm install导致~/.atom/packages/下文件属主为root，Atom 拒绝加载，应改用普通用户权限安装 - 新装主题没出现在下拉菜单里，先检查是否带
-ui或-syntax后缀，再确认最近更新时间是否在半年内
编辑区字体靠 config.cson，其他 UI 元素必须用 styles.less
Settings → Editor 里填的 fontFamily 和 fontSize 只作用于代码编辑区（即 atom-text-editor），对侧边栏、标签页、状态栏、终端输出等零影响。想统一调大，必须手动改 ~/.atom/styles.less。
打开 Atom → Stylesheet…（会自动创建或打开该文件），贴入对应规则：
.tree-view { font-size: 16px; }
.tab-bar .tab { font-size: 14px; }
.status-bar { font-size: 13px; height: 28px; line-height: 28px; }
line-height 必须和 height 一致，否则状态栏文字会上下偏移；所有规则保存后 Atom 实时重载，无需重启。但注意：styles.less 文件编码必须是 UTF-8（无 BOM），否则可能完全不生效。
连字（ligatures）不生效的三个硬性条件
开连字不是勾个选项就行，它需要三者同时满足：字体本身支持 OpenType liga 特性 + Atom 渲染层识别 + CSS 显式声明。缺一不可。
验证与配置步骤：
- 确认字体真支持：
Fira Code、JetBrains Mono、Cascadia Code是主流选择；Consolas或DejaVu Sans Mono不支持 - 在
config.cson的editor:区块下写死fontFamily，每个名字用单引号包裹，末尾必须加'monospace'保底 - 在
styles.less中添加：atom-text-editor { font-feature-settings: "liga" 1, "calt" 1; }别加text-rendering: optimizeLegibility—— 高分屏上滚动可能卡顿 - 如果仍无效，打开 DevTools（
Ctrl+Shift+I），用元素选择器检查是否被插件样式覆盖
终端插件字体需单独配置
platformio-ide-terminal、script 这类插件完全不继承主编辑器的 fontSize，它们走自己的渲染链路。
配置方式：
-
platformio-ide-terminal：进Settings → Packages → platformio-ide-terminal → Settings，调Font Size项 -
script插件：编辑~/.atom/packages/script/styles/script.less，添加.panel-body pre { font-size: 1.4rem; } - 中文显示异常？在
styles.less中给.terminal显式设字体：.terminal { font-family: "Droid Sans Mono", "Droid Sans Fallback"; }
真正容易被忽略的是：连字、中文字体 fallback、终端字号这三项，全都不受 config.cson 的 editor: 控制。它们各自有独立路径，混在一起调，十次有八次会漏掉某一块。
