atom已于2022年12月15日归档，停止更新与安全补丁；插件安装、汉化等仍可操作但兼容性下降，推荐迁移到vs code。
term3、platformio-ide-terminal）在新版系统上大概率会报错或无法加载。
apm install 失败：网络、权限与镜像问题
执行 apm install atom-simplified-chinese-menu 卡住或报 ENOTFOUND registry.npmjs.org，本质是 APM 默认源已不可靠——GitHub 关停了配套服务，国内用户实际走的是 gitcode 镜像，但 DNS 或代理常导致超时。
- 临时改源：运行
apm config set registry https://registry.npm.taobao.org/（注意淘宝源已于 2024 年停服，此命令仅对极老版本有效；当前推荐用https://npmmirror.com/） - 绕过 APM：直接 clone 到
~/.atom/packages/目录，例如：git clone https://gitcode.com/gh_mirrors/at/atom-simplified-chinese-menu ~/.atom/packages/atom-simplified-chinese-menu - 权限错误常见于 macOS / Linux：若提示
EACCES，别用sudo apm，而是修复目录归属：sudo chown -R $(whoami) ~/.atom
装了主题却不生效：UI Theme 和 Syntax Theme 必须分开选
很多人搜到 one-dark-ui 点 Install，以为完事了——结果编辑器还是白底黑字。这是因为 Atom 把界面控件样式（UI Theme）和代码着色规则（Syntax Theme）拆成两个独立开关。
- 进
Settings → Themes，左侧选 UI Theme（比如one-dark-ui），右侧选 Syntax Theme（比如one-dark-syntax） - 两者缺一不可；只装一个，另一部分会回退到 Atom 默认样式
- 若装了
atom-material-ui但报Failed to load package，说明它不兼容 Atom v1.60+，换用one-dark-ui或solarized-dark更稳妥
定制 styles.less：改颜色别碰插件源码
想调注释灰度、改标签栏高度、统一终端配色？直接改 ~/.atom/styles.less 就行，这是 Atom 启动时最后加载的样式层，优先级最高。
- 快捷打开：
Ctrl + Shift + P→ 输入Open Your Stylesheet回车 - 改背景：
atom-workspace { background-color: #1e1e1e; } - 压低注释色：
.syntax--comment { color: #6c7480 !important; }（加!important防被语法主题变量覆盖） - 终端配色不同步？不是 bug，是设计：终端（如
term3）读的是 CSS 变量--terminal-background，需在styles.less里显式定义:root块，不能指望语法主题自动透传
SLIMA 或 atom-new-tab 插件启动失败：检查 Node.js 兼容性
像 SLIMA（Lisp REPL）、atom-new-tab（一键新建文件）这类重度依赖 CoffeeScript 或旧版 Node.js API 的插件，在 Atom v1.58+ 上常出现 require is not defined 或 Cannot find module 'path' 错误。
- 根本原因：Atom 归档后 Electron 升级断层，插件未适配 Chromium 91+ 的上下文隔离机制
- 临时缓解：在
Config.cson里加"*": {"core": {"disableExtensionsOnStart": true}}，再手动启用关键插件 - 更现实的选择：确认插件 GitHub 页面最后更新时间 —— 若早于 2022 年底，基本无维护可能，建议转向 VS Code + 对应扩展（如 Calva、Project Manager）
