atom主题必须分ui theme和syntax theme两类：ui theme控制界面元素如标签页、侧边栏，通过styles/ui-variables.less定义@text-color等；syntax theme专管代码高亮，通过styles/syntax-variables.less定义@syntax-text-color等；两者变量前缀不同、不可混用，package.json须明确声明"theme": "ui"或"syntax"及"main"路径。
主题必须分 UI 和 syntax 两类，不能混装
Atom 里“主题”不是单一概念，UI Theme 控制标签页、侧边栏、状态栏等界面元素；Syntax Theme 专管代码高亮颜色和字体样式。两者独立加载、分别启用——Settings → Themes 页面有两个下拉菜单，缺一不可。
常见错误：装了 one-dark-ui 却没配 one-dark-syntax，结果界面是深色但代码全是灰底黑字；或者反过来，高亮正常但标签栏文字小得看不清。
-
UI Theme的核心变量在styles/ui-variables.less，控制@text-color、@background-color等全局 UI 色 -
Syntax Theme的核心变量在styles/syntax-variables.less，定义@syntax-text-color、@syntax-comment-color等语法节点色 - 两者变量名前缀不同（
@ui-vs@syntax-），不能互相引用，也不能靠styles.less一把梭覆盖
package.json 必须声明 theme 类型，否则 Atom 不认
新建一个主题包时，package.json 里这两行缺一不可：
"theme": "ui", "main": "./index.less"
写成 "theme": "ui-theme" 或漏掉 "main"，Atom 就不会把它当主题加载——Settings → Themes 里根本看不到它，手动启用也会失败。
-
"theme"值只能是"ui"或"syntax"，大小写敏感，不能加空格或连字符 -
"main"路径必须是相对路径，且指向一个.less文件（不是.css） -
"name"推荐全小写+短横线，比如"my-blue-ui"；含大写字母或空格会导致 apm 安装失败
Less 变量必须按顺序导入，否则编译报错
Atom 主题依赖 Less 预处理器，所有颜色最终都来自变量。如果你改了 syntax-variables.less 里的 @syntax-background-color，但 index.less 里没先 @import "./styles/syntax-variables";，编辑器就会报 LessError: variable @syntax-background-color is undefined。
-
@import语句必须出现在index.less最顶部，其他样式规则（比如.syntax--string { color: @syntax-string-color; }）必须在它之后 - 变量文件路径要写对：
styles/syntax-variables.less，不是styles/base.less或variables.less - 修改后保存，Atom 不一定实时重载——打开 DevTools（
Ctrl+Shift+I），看 Console 是否有LessError，这是最准的诊断方式
用户级覆盖优先于主题，别直接改 packages/ 下的文件
想临时调个注释颜色、改个标签栏高度？别碰 ~/.atom/packages/one-dark-ui/styles/tabs.less——下次 apm update 就被覆盖。正确做法是编辑 ~/.atom/styles.less，用更高优先级的 CSS 规则覆盖：
.tab-bar .tab {
font-size: 14px;
}
.syntax--comment {
color: #6c757d !important;
}
注意两点：一是 styles.less 编码必须是 UTF-8（无 BOM），否则整份文件不生效；二是加 !important 是为了压过主题里用变量生成的内联样式，否则可能无效。
真正做主题开发时，变量体系才是主线；日常微调，styles.less 才是最安全、最可持续的地方。变量没理清就硬改 CSS，最后容易变成一堆 !important 堆出来的补丁，谁也看不懂。
