Atom的script插件必须配置Python绝对路径,因其不继承shell虚拟环境、不读取~/.zshrc,仅依赖系统PATH;填相对路径或别名必报ModuleNotFoundError,且autocomplete-python等插件需手动配置site-packages路径并重启才生效。

script 插件必须填绝对路径,否则必报 ModuleNotFoundError —— Atom 不继承 shell 激活的虚拟环境,只查系统 PATH,这是所有运行失败的根源。
为什么 script 插件总找不到 Python 或第三方库
根本原因不是 Atom 坏了,而是它压根不读你的 ~/.zshrc、不认 source venv/bin/activate、也不管你终端里 python --version 是多少。
-
script默认执行python命令,但 macOS/Linux 多数只有python3,Windows 安装时若没勾选 “Add Python to PATH”,python根本不存在 - 即使你有虚拟环境,
script也不会自动切换过去;它只会用系统默认 Python,导致import requests直接崩 - 填相对路径(如
./venv/bin/python)或别名(如python3)会失败,必须是完整绝对路径
script 的 Command 字段怎么填才真正生效
打开 Packages → script → Settings,在 Command Options 区域操作:
- Linux/macOS:填
/path/to/venv/bin/python(不是venv/目录,是里面那个可执行文件) - Windows:填
"C:/Users/Alice Doe/venv/Scripts/python.exe"(含空格必须加英文双引号) - 验证方式:终端里运行
which python3(macOS/Linux)或where python(Windows),把输出原样粘贴进去 - 填错典型表现:
spawn python ENOENT、终端闪退、无任何输出
autocomplete-python 补全失效的真正原因和解法
它不扫描 sys.path,也不读 PYTHONPATH,只靠你手动喂路径。Jedi 引擎锁死在 0.17.x,Python 3.12+ 新语法直接静默跳过。
- 先在目标虚拟环境中运行:
python -c "import site; print(site.getsitepackages())" - 把输出的路径(如
['/home/user/proj/.venv/lib/python3.11/site-packages'])粘贴进插件设置的Extra Paths(多个路径换行分隔) - Windows 用户用正斜杠:
C:/proj/venv/Lib/site-packages,避免反斜杠转义问题 - 填完必须重启 Atom,否则不加载新路径
- 别填全局
site-packages——补全列表会混入其他项目的包,干扰判断
terminal 插件找不到 python 怎么办
platformio-ide-terminal 启动时用的是“登录 shell”的最小 PATH,图形界面启动 Atom 时通常不加载 ~/.zshrc 或 ~/.bash_profile。
立即学习“Python免费学习笔记(深入)”;
- 临时解法:终端里执行
source ~/.zshrc && atom启动(仅限命令行) - 长期规避:别依赖终端找
python,改用script插件直调绝对路径 - 别信
python别名——很多系统已移除该软链,必须显式写python3或完整路径 - 调试时看插件日志(
Window → Toggle Dev Tools → Console),而不是盲猜配置项
script、autocomplete-python、linter-flake8)长期冻结,对 Python 3.11+ 和现代虚拟环境(venv、poetry)兼容性差。真正卡住人的,从来不是怎么配,而是 Atom 根本不告诉你它用了哪个解释器、哪个 sys.path。


















