keymap.cson是唯一可靠、可复现、能覆盖插件冲突的自定义快捷键方式，需用cson格式写于~/.atom/keymap.cson（macos/linux）或%userprofile%.atom\keymap.cson（windows），结构为「选择器」+「按键」+「命令」三部分，支持注释、平台限定和!important优先级标记，不支持函数或运行时判断。
keymap.cson 是唯一可靠、可复现、能覆盖插件冲突的自定义快捷键方式。图形界面里的「Add Keybinding」按钮看似方便，但生成的规则不透明、不支持选择器条件、无法处理优先级和平台限定，实际用几次就会失效或被覆盖。
怎么写对 keymap.cson 的基本结构
文件路径是 ~/.atom/keymap.cson（macOS/Linux）或 %USERPROFILE%\.atom\keymap.cson（Windows），必须用 CSON 格式（不是 JSON，允许注释和末尾逗号）。
- 每条绑定由「选择器」+「按键」+「命令」三部分组成，缺一不可：
'atom-text-editor': 'ctrl-shift-k': 'editor:delete-line'
- 选择器决定触发范围：
atom-text-editor表示所有编辑区；.source.js表示 JS 文件；.platform-darwin可限定 macOS 系统 - 按键写法必须小写、短横线连接：
cmd-shift-p✅，Cmd+Shift+P❌，Ctrl+Up❌ - 命令名必须完整且带命名空间：
core:open-command-palette✅，open-command-palette❌，core:open-command-palettee❌（拼错就静默失败）
为什么改了没反应？常见拦截源和排查顺序
Atom 快捷键按「系统 → 插件 → core → 用户 keymap」优先级逐层匹配，你写的规则只有在没被更高优先级规则拦截时才生效。
- 先按
Ctrl+.（Windows/Linux）或Cmd+.（macOS）打开实时快捷键解析器，按你想调试的组合键，看底栏显示哪条规则被命中、来自哪个 Source - 在 Settings → Keybindings 搜索框里输入
ctrl-/，检查是否有多条同键绑定；重点看「Source」列：如果是nuclide或docblockr，说明插件抢了 - macOS 用户务必检查系统设置：「键盘 → 快捷键 → 输入源」里是否启用了
Cmd+Space或Cmd+/，这类系统级绑定 Atom 根本收不到事件 - 中文输入法（如搜狗、百度）常劫持
Cmd+Shift+P切换中英文，导致命令面板打不开——换输入法或禁用该热键
如何安全覆盖插件快捷键而不引发新冲突
直接写 'atom-text-editor': 'ctrl-s': 'prettier:format' 很容易被更精确的选择器压住（比如某个插件用了 '.source.js atom-text-editor'）。要确保你的规则胜出，得提升选择器精度或加强制标记。
- 用更具体的选择器替代宽泛匹配：
'.source.js atom-text-editor:not([mini])'比'atom-text-editor'优先级高 - 需要绝对优先？加
!important：'.source.js atom-text-editor:not([mini]) !important': 'ctrl-s': 'prettier:format'
- 想禁用某插件的绑定，别删它代码，用
unset!：'.platform-darwin .source.css atom-text-editor': 'cmd-shift-7': 'unset!'
- 多个相同选择器块会整块覆盖：后写的
'atom-text-editor'块会把前面同名块完全顶掉，别拆成三段写
Tab 键动态行为这类复杂逻辑怎么实现
像「Tab 在空行缩进、有内容时触发补全」这种上下文感知行为，纯靠 keymap.cson 无法完成——它不支持运行时判断光标前后字符。
- 这类需求必须配合
init.coffee或插件逻辑，监听core:move-up等事件后手动判断并调用对应命令 - 最简妥协方案是用「选择器条件」分流：
'atom-text-editor[data-grammar="source.js"]'和'atom-text-editor[data-grammar="text.html.basic"]'分开绑定不同命令 - 别试图在
keymap.cson里写函数或条件表达式，它只做静态匹配，不执行 JS
