Atom编辑器已于2022年12月15日正式停止维护，官方终止支持、apm服务下线、所有更新与插件托管失效；当前仅支持本地静态配置修改，无法安装或更新插件，依赖网络的功能逐步失能。
apm（Atom Package Manager）服务下线，所有核心更新、安全补丁和插件托管均已不可用。如果你仍在使用 Atom，**配置修改仍可生效，但无法安装新插件、无法更新现有插件、部分依赖远程服务的包（如 autocomplete-plus 后端、linter-eslint 的远程规则拉取）会逐步失效或报错**。
以下说明基于 Atom 最终稳定版（1.58.x）的本地配置机制，聚焦「还能实际起作用」的操作。
如何编辑 config.cson 文件
Atom 的全局配置由 ~/.atom/config.cson（macOS/Linux）或 %USERPROFILE%\.atom\config.cson（Windows）控制，是纯文本 CSON（CoffeeScript Object Notation）格式，比 JSON 更宽松（支持注释、省略引号等），但缩进敏感。
- 直接在 Atom 中按
Cmd+,（macOS）或Ctrl+,（Windows/Linux）打开 Settings → 点击右上角 Open Config Folder，再双击打开config.cson - 不要用记事本或 VS Code 直接编辑后保存为 .txt —— 必须确保文件扩展名是
.cson，且编码为 UTF-8 无 BOM - 修改后需重启 Atom 或执行
Window: Reload（Cmd+Alt+R/Ctrl+Alt+R）才生效 - 常见错误：在顶层加了多余逗号、键名漏掉引号（如写
core: { closeEmptyPanes: true, }没问题，但写core: { closeEmptyPanes: true, customFileTypes: { "source.js": ["jsx"] } }时若customFileTypes缩进不对，Atom 启动会失败并弹出解析错误
core 和 editor 关键配置项的实际效果
这两个是最常改的顶层字段，直接影响编辑体验，但部分选项在现代项目中已意义减弱：
-
core.closeEmptyPanes: 设为true后关闭最后一个 tab 不会关掉整个 pane，避免误操作退出 —— 有效 -
editor.fontSize: 只影响编辑区字体大小，不影响 tree-view 或 status-bar；设为14即可，无需单位 -
editor.showInvisibles: 显示空格/制表符，但开启后可能拖慢大文件渲染（尤其含大量空行时） -
editor.softWrap: 设为true后自动换行，但对代码可读性有争议；若配合editor.softWrapAtPreferredLineLength使用，需同时开editor.preferredLineLength（如设为100）才生效 -
core.excludeVcsIgnoredPaths: 默认true，但某些私有 Git hook 或 submodule 场景下会导致 tree-view 漏显示文件，可临时设为false排查
自定义 init.coffee 还能做什么
~/.atom/init.coffee 是 Atom 启动时执行的 CoffeeScript 脚本，可用于绑定快捷键、劫持命令、动态改 UI —— 但因无沙箱且 CoffeeScript 已淘汰，稍有不慎就导致 Atom 启动卡死。
- 添加快捷键示例（绑定
Cmd+Shift+P到 project-find）：atom.commands.add 'atom-workspace', 'custom:project-find', -> atom.commands.dispatch(atom.views.getView(atom.workspace), 'project-find:show')
然后在keymap.cson里映射：'atom-workspace': {'cmd-shift-p': 'custom:project-find'} - 禁用某个自带命令（如阻止误触
window:install-shell-commands）：atom.commands.unregister('window:install-shell-commands') - 注意：
init.coffee里不能用 ES6 语法，不支持import，所有 require 都走 Node.jsrequire()，且路径必须是绝对路径或atom.packages.resolvePackagePath()返回值
为什么 styles.less 修改后没反应
~/.atom/styles.less 控制 UI 样式（tree-view 字体、tab 高度、括号高亮色等），但它的加载逻辑被 Atom 的 shadow DOM 和样式优先级规则严重限制：
- 必须用深度选择器，例如改 tab 文字大小：
.tab .title { font-size: 12px !important; }，漏掉.tab前缀或不用!important大概率无效 - Atom 1.58+ 对
styles.less的热重载支持不稳定，改完常需手动执行Application: Reload - 部分 UI 元素（如
status-bar中的 git 分支名）使用 Web Components 封装，外部styles.less无法穿透，只能靠插件（如status-bar-plus）或改源码 - 如果用了深色主题（如
one-dark-ui），很多 class 名会带.theme-one-dark-ui前缀，直接写.tree-view不匹配，得用浏览器开发者工具（Cmd+Alt+I） inspect 元素确认真实 class
config.cson、keymap.cson、styles.less），彻底放弃装新包、不指望 lint/autoimport 类功能长期可用，把 Atom 当成一个「可配色+可调字体+带基础多光标」的轻量文本编辑器来用。 
