注释颜色改不了是因为未进入Shadow DOM影子树；Atom 1.0+必须用atom-text-editor::shadow .syntax--comment { color: #6a9955 !important; font-style: normal !important; }，缺::shadow或未重载窗口均无效。
注释颜色改不了？大概率没进对影子树
Atom 1.0+ 用 Shadow DOM 封装编辑器内容，直接写 .comment 或 .syntax--comment 不生效。必须用 atom-text-editor::shadow 进入影子树，否则样式压根不会应用到代码区。
正确写法是：
atom-text-editor::shadow .syntax--comment {
color: #6a9955 !important;
}
错误写法包括：.comment { color: #999; }、atom-text-editor .syntax--comment（缺 ::shadow）、或只写在 styles.less 外层没加包裹。
中文注释发虚、斜体难读？关掉 font-style
One Dark 等主流语法主题默认给注释加了 font-style: italic，中文渲染会模糊甚至断笔。这不是字体问题，是 CSS 斜体强制变形导致的。
atom-text-editor::shadow .syntax--comment { font-style: normal !important; }- 顺手调下字号更稳妥：
font-size: 14px; - 如果用了 Tree-sitter 解析器，作用域名可能带层级，比如
.syntax--source.syntax--js .syntax--comment，但基础场景单写.syntax--comment就够用
改完没反应？三个动作缺一不可
Atom 不自动重载用户样式，漏掉任一环节都会让你以为“写错了”。
- 保存
~/.atom/styles.less（Ctrl+S / Cmd+S） - 手动重载窗口：Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）→ 输入
Window: Reload→ 回车 - 验证是否命中：Ctrl+Alt+Shift+P →
Window: Toggle Dev Tools→ 用元素选择器悬停注释，看右侧Styles面板里最终生效的选择器是不是你写的那条
背景换了，注释突然看不清？别只动 color
把 .editor 背景改成 #1a1a1a 后，原语法主题定义的 @syntax-comment-color（比如 #999）可能对比度崩坏。这不是颜色设错了，是亮度不匹配。
必须同步覆盖关键类：
atom-text-editor::shadow .syntax--comment {
color: #6a9955 !important;
font-style: normal !important;
}
atom-text-editor::shadow .cursor {
border-color: #528bff !important;
}
光标消失、字符串泛白、括号匹配背景糊成一片——都是只改背景、不调文字色的典型后遗症。
