Atom的代码补全快捷键需按语法scope绑定，因autocomplete-plus不决定触发条件，实际由keymap.cson中选择器是否匹配当前editor的data-grammar属性决定，如source.js或source.python。
Atom 的代码补全快捷键不能靠“全局统一设置”生效，必须按语言语法（grammar）绑定，否则 Ctrl+Space 在 .js 文件里有效，在 .py 文件里就静默失败。
为什么 autocomplete-plus 的快捷键在某些文件里不触发
autocomplete-plus 本身不决定“在哪种文件里响应快捷键”，真正起作用的是 keymap.cson 中的「选择器」是否匹配当前编辑器的语法 scope。比如你写了：
'atom-text-editor': 'ctrl-space': 'autocomplete-plus:activate'
这看起来是“所有文本编辑器都响应 Ctrl+Space”，但实际效果取决于当前 editor 是否满足 atom-text-editor 这个基础选择器——它只管是否是编辑区域，不管语言。而补全 provider（如 autocomplete-javascript）是否加载，取决于右下角显示的 grammar（比如 JavaScript），不是文件后缀也不是路径。
- 常见错误：在 .ts 文件里按 Ctrl+Space 没反应 → 实际是 grammar 被设成了
TypeScript (TSX)或language-typescript，但你的 keymap 没覆盖这个 scope - 检查方法：按
Ctrl+.（Windows/Linux）或Cmd+.（macOS）打开 Keybinding Resolver，把光标放在目标文件里按快捷键，看左下角显示的 selector 是什么 - 正确做法：用带 grammar 条件的选择器，例如
'atom-text-editor[data-grammar~="source.js"]'或'atom-text-editor[data-grammar~="source.python"]'
如何为不同语言分别绑定补全快捷键
直接在 ~/.atom/keymap.cson 里按 grammar 分块写，避免互相覆盖。注意 CSON 对缩进和冒号敏感，多一个空格或少一个引号都会导致整段失效。
- JavaScript 单独用
Ctrl+Alt+Space：
'.platform-win32, .platform-linux': 'ctrl-alt-space': 'autocomplete-plus:activate' 'atom-text-editor[data-grammar~="source.js"]': 'ctrl-alt-space': 'autocomplete-plus:activate'
- Python 改用
Alt+/（避开系统输入法冲突）：
'atom-text-editor[data-grammar~="source.python"]': 'alt-/': 'autocomplete-plus:activate'
- HTML 补全保留默认
Ctrl+Space，但限定范围：
'atom-text-editor[data-grammar~="text.html.basic"]': 'ctrl-space': 'autocomplete-plus:activate'
- 多个 grammar 可合并写在一个块里，用逗号分隔，但必须确保每个 grammar 名准确（区分大小写、空格、括号）
- 别写
source.py—— 正确是source.python；也别写html—— 正确是text.html.basic
Tab 键插入补全项 vs 缩进：怎么让 Tab 在补全时确认、其他时候缩进
Atom 默认用 Enter 插入补全项，Tab 是全局缩进键。想让 Tab 在补全弹出时确认、没弹出时缩进，得靠「条件选择器 + 命令拦截」，不是简单改绑定。
- 先启用补全面板自动聚焦：Settings → Packages →
autocomplete-plus→ 勾选Confirm At Completion - 再在
keymap.cson加如下规则（仅在补全面板可见时生效）：
'atom-text-editor:not([mini])': 'tab': 'autocomplete-plus:confirm' '.autocomplete-plus': 'tab': 'core:cancel'
- 第一行表示：只要编辑器不是 mini 输入框（即非命令面板那种小框），Tab 就尝试确认补全
- 第二行是兜底：当焦点已在补全面板上时，Tab 改为关闭面板（避免误操作）
- 风险点：如果
autocomplete-plus:confirm执行失败（比如没选项可确认），Tab 会 fallback 到缩进，可能造成意外缩进 —— 这就是为什么很多人建议「别动 Tab，默认用 Enter 更稳」
快捷键冲突排查：按下去没反应，但 Keybinding Resolver 显示「No bindings found」
这不是插件坏了，而是你的选择器根本没命中当前编辑器状态。Keybinding Resolver 显示 No bindings found 意味着 Atom 根本没查到任何匹配的 rule。
- 最常漏掉的：没加
.platform-win32或.platform-darwin前缀，导致 Windows/macOS 下规则被忽略 - 语法识别错位：右下角显示
JavaScript (Babel)，但 keymap 写的是source.js→ 应该用source.babel或干脆换回原生JavaScriptgrammar - 插件未加载：provider 没装（如
autocomplete-python），autocomplete-plus 就不会注册激活逻辑，autocomplete-plus:activate命令压根不存在 - 拼写错误：
autocomplete-plus:activate少了连字符、多了空格，或写成activate-autocomplete-plus—— Atom 不报错，只是静默跳过
真正麻烦的不是写错一行，而是写对了但 scope 链断在更上游：grammar 没识别 → provider 不加载 → 命令未注册 → 快捷键无处绑定。每层都得单独验证，不能只盯着 keymap.cson 看。
