VSCode不提供图形化安装Python包功能，所有pip安装必须通过终端执行；确认当前终端Python环境是否正确是关键，80%的ModuleNotFoundError源于解释器与pip路径不一致，应使用which python（macOS/Linux）或where python（Windows）及python -m pip --version验证路径一致性。
VSCode 本身不提供图形化安装 Python 包的功能，所有依赖安装必须通过终端执行 pip 命令完成；能否成功，只取决于你当前终端所用的 Python 解释器是否正确、pip 是否可用、以及网络或源是否可达。
怎么确认当前终端用的是哪个 Python 环境
这是最常被跳过的一步，但几乎 80% 的 ModuleNotFoundError 都源于这里错配。
- 看 VSCode 右下角状态栏——它显示的是“Python 解释器”，不是“当前终端激活的环境”
- 按
Ctrl+`打开集成终端后，立即运行：which python（macOS/Linux）或where python（Windows） - 再运行：
python -m pip --version，输出路径必须和上一步python路径一致，否则说明pip指向了另一个环境 - 如果路径不一致，不要直接敲
pip install，改用：python -m pip install requests，强制走当前解释器的pip
为什么 pip install torch 总是装错或失败
torch 官方 wheel 包对 Python 版本、系统架构、CUDA 版本高度敏感，直接 pip install torch 极大概率装的是 CPU 版或版本不匹配的包。
- 去官网 https://pytorch.org/get-started/locally/ 复制对应命令（例如：
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121） - 不要加
-i镜像源——清华源等国内镜像不托管 PyTorch 的 CUDA wheel，会 fallback 到慢速官方源甚至失败 - 装完后验证：
python -c "import torch; print(torch.__version__, torch.cuda.is_available())" - 若提示
No module named 'torch'，说明装到了别的环境；若cuda.is_available()返回False但你有 GPU，大概率是 CUDA 版本不匹配
requirements.txt 生成后为什么部署还报错
pip freeze > requirements.txt 是最危险的生成方式，它会把开发期工具（如 ipykernel、black）、构建依赖（setuptools、wheel）甚至 VSCode 插件依赖全塞进去。
立即学习“Python免费学习笔记（深入）”；
- 真正该用的是
pipreqs . --force：它只扫描.py文件里的import语句，生成最小必要依赖集 - 如果项目有
pyproject.toml，优先用pip-tools：pip install pip-tools→ 编辑requirements.in→ 运行pip-compile requirements.in - 生成后检查是否有
pkg-resources==0.0.0或editables==这类非 PyPI 包——它们是虚拟环境元数据，必须手动删掉 - CI/CD 中务必用
pip install --no-deps -r requirements.txt先装依赖，再pip install -e .装当前项目，避免循环依赖
装完包 import 还标红，重启 VSCode 也没用
这不是 VSCode 卡了，而是 Pylance（默认语言服务器）没刷新导入路径缓存，尤其在切换解释器或离线安装后。
- 先在终端里跑：
python -c "import requests; print(requests.__file__)"，确认包确实装在当前解释器的site-packages下 - 然后在 VSCode 里按
Ctrl+Shift+P，输入Python: Restart Language Server，强制重载分析上下文 - 如果仍标红，检查
settings.json是否有硬编码的"python.defaultInterpreterPath"，且路径指向已删除的虚拟环境 - 别依赖自动检测——VSCode 对
.venv的识别有时会延迟几秒，选完解释器后等 2 秒再开终端
真正麻烦的从来不是“怎么装”，而是“装到哪儿去了”——每个 pip 命令背后都绑着一个隐式环境，而 VSCode 的终端、调试器、语言服务器三者可能各自认不同的“那儿”。
