VSCode中pip install后import失败，90%因解释器未对齐：需确认右下角状态栏显示路径与终端执行python -c "import sys; print(sys.executable)"输出一致，选解释器后必须重启窗口，统一用python -m pip install，并检查调试器、终端、语言服务器三者路径是否统一。
VSCode里pip install完包却import失败，90%是解释器没选对，不是pip命令写错了。
怎么确认当前VSCode用的是哪个Python解释器
右下角状态栏会显示类似 Python 3.11.9 ('venv': venv) 或 Python 3.12.3 (/usr/bin/python3) 的文字——这行就是真实生效的解释器路径。它不等于你终端里 which python 的结果，也不等于你手动 source venv/bin/activate 后看到的提示。
常见错误现象：
- 终端里
pip install requests成功，但VSCode里import requests报ModuleNotFoundError - 按
Ctrl+Shift+P输入Python: Select Interpreter，列表里出现多个python.exe，但没标清楚哪个对应你的venv
实操建议：
立即学习“Python免费学习笔记（深入）”；
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 点击右下角那个解释器标识，从弹出菜单中选带
venv、.venv或env字样的路径（Windows看Scriptspython.exe，macOS/Linux看bin/python） - 选完后，立刻打开集成终端（
Ctrl+`），运行python -c "import sys; print(sys.executable)"，输出路径必须和右下角显示的一致 - 如果终端里
python指向别处，说明VSCode没接管终端——此时必须用python -m pip install xxx，而不是直接pip install xxx
生成requirements.txt时为什么不能用pip freeze
pip freeze 会把当前环境里所有包都列出来，包括 pip、setuptools、wheel、ipykernel 甚至 VSCode 插件依赖（比如 pylsp），这些不该进生产依赖清单。
使用场景：
- 你刚初始化一个新项目，只写了几个文件，import了
requests和pandas，但pip freeze输出里还有black==24.4.0、mypy==1.10.0 - CI/CD 构建时安装了多余包，增大镜像体积，还可能引发隐式兼容问题
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 优先用
pipreqs：先pip install pipreqs，再在项目根目录运行pipreqs . --force --encoding=utf-8，它只扫描.py文件里的import语句 - 如果项目有
pyproject.toml且用 Poetry 或 pip-tools，就别碰pip freeze：改用poetry export -f requirements.txt --without-hashes > requirements.txt或pip-compile requirements.in - 生成后手动检查：确保没有
pkg-resources==0.0.0、editables==0.5这类开发期包；线上部署必须带版本号，如requests==2.31.0，不能只写requests
自动化脚本跑不起来，但手动执行同一行命令却OK
VSCode“运行”按钮（Ctrl+F5 或右键 → “Run Python File in Terminal”）默认不激活虚拟环境，也不会读取 .bashrc 或 .zshrc 里的 source venv/bin/activate。
常见错误现象：
- 写了个
deploy.py脚本，里面调用了subprocess.run(["pip", "install", "-r", "requirements.txt"])，运行时报ModuleNotFoundError - 脚本开头写了
#!/usr/bin/env python，但实际执行的是系统 Python，不是你的venv
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 脚本第一行改成
#!/path/to/your/venv/bin/python（macOS/Linux）或硬编码 Windows 路径（不推荐） - 更可靠的做法：在脚本里用
sys.executable获取当前解释器路径，再拼出 pip 路径：pip_path = Path(sys.executable).parent / "pip"，然后subprocess.run([pip_path, "install", ...]) - 调试前，在
.vscode/launch.json中显式指定解释器："python": "./venv/bin/python"（macOS/Linux）或"python": ".\venv\Scripts\python.exe"（Windows）
为什么VSCode调试时找不到包，但终端里能import
调试器（Debugger）和集成终端（Terminal）用的是两套环境配置逻辑。终端靠你手动激活或VSCode自动注入，而调试器只认 launch.json 或 settings.json 里写的路径，完全不看你终端有没有 source 过。
容易被忽略的地方：
-
.vscode/settings.json里写了"python.defaultInterpreterPath"，但launch.json里没配"python"字段，调试时仍可能 fallback 到默认解释器 - 项目根目录下有多个
venv文件夹（比如venv和.venv），VSCode 有时会识别错目录 - 你改过解释器路径，但没重启 VSCode 窗口——VSCode 不会热重载 Python 解释器配置
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 删除
.vscode/launch.json，重新通过Ctrl+Shift+P → Python: Configure Debugging生成，它会自动填入当前选中的解释器路径 - 在
launch.json的配置项里加一行："console": "integratedTerminal"，这样调试时会复用已激活环境的终端，减少错位 - 临时验证方法：在调试断点处加一句
import sys; print(sys.executable)，输出路径必须和右下角一致
最麻烦的不是不会装包，而是环境路径在解释器、终端、调试器、子进程之间悄悄分裂——每次换项目，都要重新核对这四条路径是否真正指向同一个 python 可执行文件。
