styles.less 必须放在用户配置目录（如 ~/.atom/styles.less）才生效，插件或项目目录下的同名文件无效；改代码区域颜色需用 atom-text-editor::shadow 前缀并加 !important；语法高亮须按 scope 添加 .syntax-- 前缀。
styles.less 文件必须放在用户配置目录下才生效
改错路径等于白干。Atom 只认用户级 ~/.atom/styles.less（macOS/Linux）或 %USERPROFILE%\.atom\styles.less（Windows）。插件目录里、项目根目录下、甚至全局安装路径里的同名文件，全都不起作用。
最稳妥的打开方式是：按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Application: Open Your Stylesheet 回车——它会自动创建并打开正确路径的文件。
常见失效原因：
- 文件名写成
style.less或styles.css - 编辑时被其他程序锁住（比如用记事本另存为带 BOM 的 UTF-8）
- 保存后没触发重载（快捷键
Ctrl+Shift+F5或命令面板执行Window: Reload）
改代码区域颜色必须用 ::shadow 包裹选择器
Atom 1.0+ 强制使用 Shadow DOM 封装编辑器内容，直接写 .editor { background-color: #222; } 完全无效。浏览器根本查不到这个节点。
正确写法必须带 atom-text-editor::shadow 前缀：
atom-text-editor::shadow .editor {
background-color: #252525 !important;
}
atom-text-editor::shadow .line-numbers {
background-color: #1e1e1e !important;
}
!important 不是可选项——当前 Syntax Theme 的默认样式权重更高，不加就可能被覆盖。
别漏掉关键部分：
-
.cursor要单独设边框色，否则光标可能变透明 -
.selection和.highlight也得同步调，否则选中背景和查找高亮会突兀 - 如果用了
minimap插件，它的背景要额外写.minimap .minimap-scroll-marker
自定义代码提示（autocomplete）背景色不能靠换主题解决
补全框是独立浮层，不受 UI Theme 或 Syntax Theme 影响。想改它，只能手动写 .autocomplete-plus 相关规则。
核心选择器就三个：
-
.autocomplete-plus .list-group：整个下拉容器 -
.autocomplete-plus .list-item：每一行候选项 -
.autocomplete-plus .list-item.selected：当前高亮项
示例（适配深色背景）：
.autocomplete-plus .list-group {
background-color: rgba(30, 30, 30, 0.95);
}
.autocomplete-plus .list-item {
color: #ddd;
}
.autocomplete-plus .list-item.selected {
background-color: #444 !important;
color: #fff;
}
注意：background-color: transparent 很危险——会透出底层窗口，导致文字难读；用 rgba() 控制半透更安全。
改语法高亮颜色必须查 scope 并加 .syntax-- 前缀
代码颜色不是靠 class 控制的，而是靠 TextMate scope。比如想让 JS 的 console.log 变蓝，先将光标停在 console 上，按 Ctrl+Alt+Shift+P（Win/Linux）或 Cmd+Alt+P（macOS），状态栏会显示类似 source.js support.function.console.js 的路径。
把它转成 CSS 选择器时，每一段都要加 .syntax-- 前缀：
.syntax--source.syntax--js .syntax--support.syntax--function.syntax--console {
color: #4285f4 !important;
}
漏一个 .syntax--，整条规则就失效。别指望靠 .editor .comment 这种宽泛写法——它匹配不到任何 scope 元素。
另外，改完记得检查 Syntax Theme 是否已启用：Settings → Themes → 确保 Syntax Theme 下拉框里选中的是你正在调试的那个主题（如 one-dark-syntax）。
