直接改 styles.less 是唯一可靠路径，atom 不允许通过修改主题源码、核心文件或 ui theme 改代码颜色；语法高亮由语言包（提供 scope）和语法主题（定义样式）共同决定，用户只能通过 ~/.atom/styles.less 干预，须用 atom-text-editor::shadow 前缀、syntax-- 类名及 !important 确保生效。
直接改 styles.less 是唯一可靠路径
Atom 不允许你通过修改主题源码、编辑核心文件或调整 UI Theme 来改变代码颜色——那些操作全无效。语法高亮由语言包（提供 source.python、syntax--string 这类 scope）和语法主题（定义这些 scope 的 CSS 样式）共同决定，而用户能稳定干预的只有 styles.less。
打开 Atom → Atom → Stylesheet…（macOS）或 Edit → Stylesheet…（Windows/Linux），它会自动打开 ~/.atom/styles.less。所有自定义都必须写进这个文件，保存后立即热更新，无需重启。
- 务必使用
atom-text-editor::shadow前缀，否则选择器不命中（Atom 1.0+ 用 Shadow DOM 封装编辑器内容） - 语法类名必须带
syntax--前缀，比如.syntax--comment，不能写成.comment - 几乎总要加
!important，否则语法主题的 CSS 优先级更高，你的样式被覆盖 - 改错可能导致文字消失（例如设
color: transparent）或光标不可见，记得同步补上.cursor { border-color: ... !important; }
怎么精准定位想改的语法元素？
别靠猜。把光标放在你要调色的代码位置（比如一段注释、一个字符串、一个函数名），按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Win/Linux），输入 Editor: Log Cursor Scope 回车。第一行输出就是当前作用域链，例如：
.source.js .syntax--comment.line
这说明你该写：
atom-text-editor::shadow .syntax--comment.line { color: #4caf50 !important; }
- 常见 scope：
.syntax--string、.syntax--keyword、.syntax--function、.syntax--class、.syntax--punctuation.bracket - Vue/TSX 等需先确认 scope 是否正确（如
source.vue而非text.html.vue），否则样式根本不会应用 - 中文注释发虚？加
font-style: normal;关掉默认斜体
背景色换了，但注释/字符串看不清了怎么办？
语法主题的颜色变量（比如 @syntax-text-color）是按预设背景亮度设计的。如果你只改了 .editor 背景（如设为 #1a1a1a），却不相应调亮关键语法类，对比度就崩了。
- 别只动背景，顺手覆盖几类高频元素：
.syntax--comment、.syntax--string、.syntax--keyword - 光标消失？补
atom-text-editor::shadow .cursor { border-color: #528bff !important; } - 选中区域太刺眼？加
atom-text-editor::shadow .selection.region { background-color: rgba(80, 140, 255, 0.2) !important; } - 活动行高亮别用
highlight-line插件——它已彻底废弃，API 兼容失效；改styles.less更稳：.atom-text-editor::shadow .line.cursor-line { background-color: rgba(255, 220, 120, 0.1) !important; }
为什么换语法主题后颜色没变？
因为“换主题”不等于“启用主题”。很多人装了 one-light-syntax，却没在设置里手动选中它。
- 打开 Atom → Preferences → Themes（macOS）或 Edit → Preferences → Themes（Win/Linux）
- 在 Syntax Theme 下拉框中，选中你刚安装的主题（不是 UI Theme！）
- 安装后不会自动激活，必须手动点选；旧文件可能缓存样式，可右键标签页 → Reopen File 刷新
- 注意主题适配性：深色主题（如
one-dark-syntax）配浅色 UI 可能导致按钮看不清，反之亦然
真正难的不是写几行 CSS，而是搞清 scope 从哪来、为什么没生效、哪些地方必须加 !important。一旦漏掉 ::shadow 或写错 scope 名，样式就静默失效——它不会报错，只会让你反复怀疑自己写错了。
