Atom Python补全需grammar为source.python、启用autocomplete-python和ide-python、keymap绑定Tab确认三者协同；右下角显示Plain Text或带括号的Python变体均无效，必须手动选“Python”，且python-language-server状态栏显示connected才生效。
Atom 的 Python 补全和检查功能不会自动生效，装完插件只是第一步；真正起作用需要 grammar 正确、provider 匹配、keymap 重绑三者同时到位，缺一不可。
右下角显示 Plain Text 或 Python (Jedi)？补全根本不会触发
autocomplete-python 和 ide-python 都只响应 source.python scope。如果右下角显示的是 Plain Text、Python (Jedi) 或 Python (VirtualEnv)，说明 language-python 插件没识别出当前文件是标准 Python，补全逻辑直接跳过。
- 点击右下角文字 → 手动选
Python（注意：不是带括号的任何变体） - 确认
language-python插件已启用（Settings → Packages → 搜索 language-python → 状态为蓝色 Enabled） - 新建文件后务必先保存为
.py后缀，否则 Atom 不会自动设 grammar
autocomplete-python 装了但只补 os.path.join，不补你写的函数参数？这是设计如此
autocomplete-python 本身只基于 AST 和内置模块做静态补全，不分析你本地代码的变量定义或函数签名。它能补 os. 后的 listdir，但补不了 fetch_data( 后的 url 参数名——这不是 bug，是能力边界。
- 要参数级提示（含类型、文档、占位符），必须额外安装
ide-python（它会自动拉取python-language-server） - 装完后看 Atom 底部状态栏：出现 Python Language Server 图标且状态为
connected才算生效 - 若显示
disconnected，运行pip install python-language-server，并在ide-python设置中确认pythonPath指向正确的解释器（如/usr/bin/python3）
Tab 键按了没反应？Atom 默认用 Enter 确认补全
Atom 默认行为是 Enter 插入建议、Tab 只缩进。想用 Tab 插入并跳转到占位符（比如 print(${1:text}) 中的 ${1:text}），必须手动改 keymap。
立即学习“Python免费学习笔记（深入）”；
- Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Win/Linux）→ 输入
Open Your Keymap - 在打开的
keymap.cson里加这段：
'atom-text-editor[data-grammar~="source.python"]:not([mini])': 'tab': 'autocomplete-plus:confirm'
注意：autocomplete-python 自身不提供 ${1:} 占位符；真正生成它们的是 python-snippets 插件。如果 Tab 补全后光标没停在括号里，先装这个插件，再确认它的 scope 是 .source.python。
补全卡顿、延迟高？别只调 delayTime
autocomplete-plus 的 Delay Time 配置只是表象。真正拖慢补全的常是 provider 响应慢，尤其是 python-language-server 在首次加载项目时解析依赖耗时明显。
- 首次打开大项目时，等底部状态栏显示
connected再开始写代码，避免频繁触发未就绪的补全请求 - 禁用所有名字含
autocomplete-atom-api、python-tools的旧插件——它们会覆盖getSuggestions方法，导致控制台报Uncaught TypeError: Cannot read property 'getSuggestions' of undefined - Windows 用户装完新插件务必重启 Atom；后台进程常驻，不重启插件根本不加载
最常被忽略的是：补全链路上任何一个环节（grammar / provider / keymap）出错，现象都是“没反应”，但原因完全不同。查问题时别猜，先开 Keybinding Resolver（Ctrl+.）看按键是否被拦截，再看右下角 grammar 是否对，最后看控制台有没有 getSuggestions 相关报错。
