必须写 atom-text-editor::shadow 才能生效，否则背景图和透明度全失效；所有关键样式需加 !important；背景图须加 text-shadow 遮罩；窗口级透明不可通过 styles.less 实现；改完必须手动 window: reload。
atom-text-editor::shadow 必须写，否则背景图和透明度全失效
Atom 1.0+ 使用 Shadow DOM 封装编辑器内容，.editor、.line-numbers 等节点根本不在主文档树里。直接写 .editor { background: url(...) } 或 .editor { background-color: rgba(0,0,0,0.3) } 完全不生效——浏览器压根找不到这个元素。
必须用 atom-text-editor::shadow 进入影子树才能控制，这是所有自定义背景的前提。漏掉这层，后面全白忙。
-
atom-text-editor::shadow .editor控制代码行区域（含空行、折叠图标） -
atom-text-editor::shadow .line-numbers控制左侧栏，不单独设会和代码区糊成一片 - 所有关键样式都得加
!important，否则被当前 Syntax Theme 的默认规则覆盖
背景图片要加遮罩，否则注释和字符串看不清
直接设 background: url('/path/to/wallpaper.jpg') no-repeat center / cover 后，你会发现 .syntax--comment、.syntax--string 文字发虚、反光、甚至完全消失——不是图片太亮，是文字没做视觉隔离。
必须叠加一层半透明遮罩或文字阴影，让语法高亮在任意壁纸下都可读：
- 推荐用
text-shadow: 0 0 8px rgba(0,0,0,0.7)给关键语法类加柔边，比纯色遮罩更自然 - 只加在
.syntax--comment、.syntax--string、.syntax--keyword上，别全局套用，否则光标和括号匹配也变糊 - 如果壁纸本身明暗对比强，建议同时调低
background-attachment: fixed的干扰感，改成scroll更稳
半透明 ≠ 窗口透明，别指望桌面“透进来”
很多人以为设了 background-color: rgba(0,0,0,0.2) 就能让 Atom 窗口变成毛玻璃效果——实际只是编辑区 DOM 元素带了 alpha，最外层 Electron 窗口仍是实心的，桌面背景根本穿不透。
真正想实现窗口级透明，必须改启动参数或重编译 Atom 源码，styles.less 做不到。但你大概率不需要那么激进：
- 仅设
atom-text-editor::shadow .editor { background-color: hsla(0,0%,10%,0.25) }就能获得和深色桌面融合的柔和感 -
.line-numbers和.tab-bar .tab也同步设为同系列hsla()，避免色差断层 - 别对
html或atom-workspace设透明，会导致折叠箭头、Git 状态图标等 UI 元素异常淡出甚至消失
改完必须手动重载，Window: Reload 不是可选项
Atom 不监听 styles.less 文件变更，保存后界面毫无反应是正常现象。不执行 Ctrl+Shift+P → 输入 Window: Reload，所有修改都处于“待生效”状态。
常见卡点：
- 重载后光标变淡？补一行
atom-text-editor::shadow .cursor { border-color: #528bff !important; } - 行号看不清？不是颜色错了，是
.line-numbers背景和文字色没同步调，比如color: #aaa配background-color: #1e1e1e - 用了 minimap 或 git-diff 插件？它们的背景色也得单独覆盖，例如
.minimap .minimap-scroll-marker，否则会出现“局部不透明”的割裂感
Window: Reload——没有它，前面所有操作等于没做。
