VSCode中pip install安装位置取决于终端激活的Python环境，而非状态栏显示的解释器；必须手动激活虚拟环境或配置"python.terminal.activateEnvironment": true使新终端自动生效，否则易装错环境导致ModuleNotFoundError。
VSCode 本身不提供独立的 Python 包管理命令，所有 pip 相关操作都依赖你当前终端中激活的 Python 解释器环境——也就是说，pip install 走的是哪个 Python，就装到哪个环境里；装错位置、模块找不到，90% 是因为终端没对上解释器。
终端里运行 pip install 时，到底在哪个环境装？
VSCode 的“Python 解释器”设置（左下角点击选择）只影响代码运行、调试和语言服务，不自动同步到终端。新开的集成终端默认启动的是系统 shell（如 PowerShell / zsh），PATH 里的第一个 python 和 pip 才是实际调用目标。
- 验证方式：在终端中运行
which python（macOS/Linux）或where python（Windows），输出路径必须和状态栏显示的解释器路径一致 - 常见错配：状态栏显示
./.venv/bin/python，但终端里which python返回/usr/bin/python——说明虚拟环境根本没激活 - 不要依赖
pip命令本身：始终优先用python -m pip install xxx，这样能强制走当前解释器附带的pip
如何让新终端自动激活当前选中的虚拟环境？
手动运行 source .venv/bin/activate（Linux/macOS）或 .venv\Scripts\activate.bat（Windows）太重复。更可靠的方式是启用 VSCode 的自动激活机制：
- 在
settings.json中添加："python.terminal.activateEnvironment": true - 确保
python.defaultInterpreterPath已正确指向你的虚拟环境内 Python（如"./.venv/bin/python"） - 重启终端（关闭再开，不是刷新）才能生效；已打开的终端不会自动补激活
- 注意：该设置仅对通过 VS Code 启动的终端生效，不影响外部终端或
Ctrl+Shift+P → Terminal: Create New Terminal以外的创建方式
Python: Install Package 功能底层调什么？
这个命令面板选项（Ctrl+Shift+P → Python: Install Package）看起来方便，但它只是语法糖：
立即学习“Python免费学习笔记（深入）”；
- 它会调用当前选中解释器路径下的
pip，等价于执行/path/to/your/venv/bin/python -m pip install xxx（Linux/macOS） - 前提是该解释器目录下存在
pip模块；如果提示No module named pip，说明虚拟环境创建时未带 pip（比如用了venv --without-pip） - 它不处理依赖冲突，也不更新
requirements.txt；装完包后需手动运行pip freeze > requirements.txt - 如果终端里刚手动装过包但代码仍报
ModuleNotFoundError，大概率是语言服务器缓存未刷新——按Ctrl+Shift+P→Python: Restart Language Server
为什么装完包，import 还是失败？
最常被忽略的一点：VSCode 的 Jupyter Notebook 内核和普通 Python 文件运行环境不是完全共享的。即使你在终端里激活了虚拟环境、也用对了解释器，Notebook 可能还在用旧内核。
- 检查右上角内核名称是否包含你期望的虚拟环境路径（如
Python 3.11.5 ('.venv': venv)） - 内核名称没变？点 Kernel →
Change kernel重新选一次，或直接Restart Kernel - 如果用的是远程解释器（SSH/WSL），确保
pip安装发生在同一上下文——本地终端里装，远程环境里肯定找不到 - 别在系统 Python 里装包然后指望虚拟环境能 import；环境隔离是硬性的，没有“继承”这回事
