Keymap文件位于~/.atom/keymap.cson（macOS/Linux）或%USERPROFILE%.atom\keymap.cson（Windows），修改后需重启Atom或执行Window: Reload才生效；常见失效原因包括语法错误、路径错误、未保存或误改其他配置文件。
Keymap文件在哪，改了为什么没生效
Atom 的快捷键配置不走图形界面，全靠编辑 keymap.cson 文件。它默认位于用户主目录下的 ~/.atom/keymap.cson（macOS/Linux）或 %USERPROFILE%\.atom\keymap.cson（Windows）。改完必须重启 Atom 或执行 Window: Reload 命令（Ctrl+Alt+R / Cmd+Alt+R），否则改动完全不加载。
常见错误现象：keymap.cson 语法写错（比如多一个逗号、少一个引号）、路径不对、文件被 Atom 锁定未保存成功、或者误改了 init.coffee 或 config.cson —— 这些地方改快捷键一律无效。
- 用 Atom 自带的
Application: Open Your Keymap命令打开文件，最安全；别手动记路径找错位置 - CSON 是 CoffeeScript 的子集，支持注释（
#开头），但不支持 JSON 风格的双引号字符串；键名必须用单引号，如'core:save' - 如果已有同快捷键绑定，后加载的规则会覆盖前面的——顺序很重要，建议把自定义规则放在文件末尾
怎么绑定 Ctrl+S 为格式化而不是保存
Atom 默认把 Ctrl+S 绑定到 core:save，想改成调用 Prettier 或 js-beautify，得先解除原绑定，再加新规则。不能只写一条新绑定，否则两个命令会同时触发。
关键点在于作用域（scope）和命令名。比如你想只在 JavaScript 文件里用 Ctrl+S 格式化，就得限定 scope：'.source.js'；命令名取决于你装的插件，Prettier 插件是 'prettier:format'，js-beautify 是 'js-beautify:beautify-editor'。
- 先禁用原绑定：
'*': 'ctrl-s': 'unset!'
- 再按需绑定：
'.source.js': 'ctrl-s': 'prettier:format' '.source.css': 'ctrl-s': 'prettier:format'
- 注意：某些插件（如 prettier-atom）需要先启用“格式化时自动保存”选项，否则
prettier:format可能静默失败
为什么快捷键在某些面板里不生效
Atom 的快捷键有作用域层级，比如命令面板（Cmd+Shift+P）、设置视图（Cmd+,）、树视图（左侧文件列表）都属于不同 scope。你在 *' 下写的绑定，在这些面板里大概率不触发，因为它们有自己的 keymap 上下文。
典型表现：你在编辑器里绑了 Ctrl+K Ctrl+F 格式化，但在命令面板里按它却弹出“查找”，说明该快捷键在 .platform-darwin .command-palette 这个 scope 下另有定义。
- 查当前焦点区域的 scope：打开开发者工具（
Window: Toggle Dev Tools），运行atom.workspace.getActiveTextEditor()?.getGrammar().scopeName，或看右下角状态栏显示的 grammar 名 - 精准覆盖要加完整 scope，比如让快捷键在命令面板生效：
'.command-palette': 'ctrl-k ctrl-f': 'prettier:format'
- 慎用全局绑定（
*），容易和系统/其他插件冲突；优先用语言 scope 或具体面板 scope
Mac 上 Cmd 键和 Ctrl 键经常混淆
macOS 用户最容易踩的坑：把 cmd 写成 ctrl，或反过来。Atom 的 keymap 中，Mac 系统用 cmd 表示 ⌘ 键，ctrl 是 Control 键（对应 Windows 的 Ctrl），不是“系统级 Ctrl”。写反会导致快捷键在 Mac 上完全不响应。
另一个现实问题是：有些键盘映射工具（如 Karabiner）或终端复用器（如 iTerm2）会劫持 cmd 键行为，导致 Atom 收不到原始事件。这不是 Atom 配置问题，而是输入链路被截断了。
- Mac 正确写法：
'cmd-s'（存文件）、'cmd-alt-l'（重载窗口）；Windows/Linux 对应写'ctrl-s'、'ctrl-alt-l' - 跨平台统一写法不可行；如果团队共用 keymap，建议用平台条件分支：
'.platform-darwin': 'cmd-s': 'unset!' '.platform-win32, .platform-linux': 'ctrl-s': 'unset!'
- 测试快捷键是否被系统吃掉：在 Atom 外任意文本框（如备忘录）里按相同组合键，看是否有反应；没反应就不是 Atom 的问题
真正麻烦的从来不是改哪一行，而是改完之后不知道它到底在哪个上下文里起效、又在哪个角落被悄悄覆盖掉了。Scope 和平台标识符这两个点，漏一个，快捷键就等于白配。
