Atom Python开发需三步：装language-python实现语法高亮；配置系统PATH确保python命令可用；设置autocomplete-python的Extra Paths指向正确site-packages以支持第三方库补全。
Atom 打开 Python 文件没语法高亮
默认安装的 Atom 不认识 .py 文件，连基础高亮都没有。这不是插件问题，是语言包没装——Atom 把“识别某种文件”和“提供语法高亮”拆成两个独立模块。
- 必须装
language-python（官方维护，自动启用）；手动装错成language-python3之类非官方包，反而可能冲突 - 装完不用重启，但得关掉再打开已存在的
.py文件，否则编辑器缓存还按纯文本处理 - 如果文件扩展名不是标准
.py（比如.pyw或自定义后缀），要在Config → Core → Custom File Types里加映射："source.python": ["\.pyw$"]
运行 Python 脚本时提示 python: command not found
Atom 本身不带 Python 解释器，所有运行插件（如 script）都靠调系统命令。报这个错，90% 是环境变量没进 Atom 进程。
- macOS：如果用 Launchpad 启动 Atom，它继承的是 shell 的 PATH；但如果你从终端用
atom .启动，PATH 才完整。推荐始终用终端启动 - Windows：检查
where python是否有输出；若无，把 Python 安装目录（如C:Users ameAppDataLocalProgramsPythonPython311）加进系统 PATH，再彻底关闭 Atom（任务管理器里杀干净） - Linux：确认
python3命令可用；script插件默认调python，需在插件设置里把 Command 改成python3
autocomplete-python 不补全第三方库（如 requests、numpy）
这个插件依赖 python-jedi 引擎，而 jedi 默认只索引标准库和当前项目下的模块。外部包不在它的“视野”里，除非你告诉它路径。
- 先确认已安装
jedi：终端执行pip show jedi，版本建议 ≥0.18（老版本对 type hint 支持差） - 在 Atom 设置里找到
autocomplete-python插件，把Extra Paths设为你的 site-packages 目录，例如：/home/user/.local/lib/python3.11/site-packages - 虚拟环境用户注意：不能填全局 site-packages；要用
python -c "import site; print(site.getsitepackages())"查当前环境路径，再填进去
调试 Python 用不了断点，atom-debugger 已停更
Atom 社区早已放弃维护官方调试支持，atom-debugger 和配套的 python-debugger 插件 2020 年后就不再更新，无法兼容 Python 3.10+ 的 AST 变化，断点直接失效。
立即学习“Python免费学习笔记（深入）”；
- 别浪费时间配
debugger类插件——它们现在要么报错，要么断点不命中，没有稳定方案 - 务实做法：用
print()+logging，或切到终端跑python -m pdb script.py - 如果真需要图形化调试，不如直接换 VS Code：它对 Python 的调试支持是当前 Atom 完全没法比的，且免费
Atom 做 Python 开发，核心就三件事：写得清（language-python）、跑得通（PATH 对）、补得上（jedi 路径对）。其他功能越强求，越容易卡在半路。
