script插件必须填虚拟环境的绝对Python路径，如Linux/macOS填/path/to/venv/bin/python、Windows填"C:/Users/Alice Doe/venv/Scripts/python.exe"（含空格需加引号），否则因不继承shell激活环境而报ModuleNotFoundError；autocomplete-python的Extra Paths须填site.getsitepackages()返回的site-packages路径，非venv根目录；platformio-ide-terminal找不到python是因GUI启动未加载~/.zshrc；linter-flake8需在激活环境下安装并配置对应环境中的flake8路径。
script插件必须填绝对路径，不能依赖python命令
Atom 的 script 插件默认执行 python，但它不继承 shell 激活后的虚拟环境，只查系统 PATH。结果就是：明明 source venv/bin/activate 后终端里 python -c "import requests" 能过，Atom 里一运行就报 ModuleNotFoundError。
解决方式只有一条：在 script 设置页的 Command 字段，手动填虚拟环境里真实的 Python 可执行文件路径：
- Linux/macOS：
/path/to/venv/bin/python（注意不是venv/根目录） - Windows：
C:/project/venv/Scripts/python.exe（含空格时必须用英文双引号包裹，例如"C:/Users/Alice Doe/venv/Scripts/python.exe"） - 填错的典型表现：终端闪退、无输出、或报
spawn python ENOENT
autocomplete-python 的 Extra Paths 要填 site-packages，不是 venv 根目录
这个插件靠 Jedi 补全第三方库（如 requests、numpy），但 Jedi 默认不扫描虚拟环境的包目录。它不会自动读取 sys.path 或 PYTHONPATH，必须人工喂路径。
正确做法是先在目标虚拟环境中运行：
python -c "import site; print(site.getsitepackages())"
输出类似 ['/home/user/project/.venv/lib/python3.11/site-packages']，把这个路径粘贴进 autocomplete-python 插件设置里的 Extra Paths（多个路径用换行分隔）。注意：
- Windows 用户建议用正斜杠写法：
C:/project/venv/Lib/site-packages，避免反斜杠转义问题 - 填完必须重启 Atom，否则不生效
- 别填全局
site-packages——那会导致补全列表混入你系统里装的其他项目包，干扰判断
platformio-ide-terminal 启动后找不到 python，本质是 shell 配置没加载
macOS/Linux 下从图形界面（Launchpad/Dock）启动 Atom，它的终端插件继承的是“登录 shell”的最小 PATH，通常不加载 ~/.zshrc 或 ~/.bash_profile 里的 export PATH=...。所以即使你在终端里能 python --version，Atom 终端里却报 command not found。
临时解法（仅限命令行启动）：
- 终端里执行
source ~/.zshrc && atom .（macOS Catalina+ 默认 zsh）
更稳的长期做法：
- 改用
script插件直接调用绝对路径，绕过终端环境依赖 - 或者在 Atom 设置里把终端的
Shell Override设为/bin/zsh -i（加-i表示交互式，会加载配置）
linter-flake8 找不到模块，是因为它用了系统 Python 而非项目环境
这个错误不是插件坏了，而是 linter-flake8 在后台调用 flake8 时，用的是系统 Python 解释器，但检查代码时又去项目环境里 import 模块，路径错位导致失败。
正确安装和配置流程：
- 先激活你的虚拟环境：
source .venv/bin/activate（Linux/macOS）或.venv\Scripts\activate（Windows） - 再运行：
pip install flake8（确保装到当前环境） - 进 Atom 设置 →
linter-flake8→ 把Executable Path改成：.venv/bin/flake8（Linux/macOS）或.venv\Scripts\flake8.exe（Windows） - 如果用
poetry，得先poetry shell进入环境，再pip install flake8；poetry run flake8无法被插件直接调用
最麻烦的其实是调试盲区：Atom 不告诉你它到底用了哪个 Python、哪个 sys.path。遇到奇怪问题，第一反应不该是重装插件，而是打开开发者工具（Window → Toggle Dev Tools），切到 Console 标签，看插件日志里打印的实际路径和错误堆栈——这事本身就很消耗判断力。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
