在 vs code 中装库必须使用集成终端（ctrl+`），先确认并选对 python 解释器环境，再执行 pip install；避免右键运行文件、误用系统 python 或 sudo，注意源地址、路径一致性及 requirements.txt 兼容性。
在 VS Code 里用终端装库，别点“运行”按钮
VS Code 自带的集成终端（Ctrl+`）就是你装库的主战场，不是靠右键菜单或扩展按钮。很多人点错位置，比如在 Python 文件里右键选“Run Python File”，结果库根本没装到当前环境里——那只是执行代码，不负责装包。
- 先确认终端激活的是你要用的 Python 环境：
which python（macOS/Linux）或where python（Windows），输出路径得跟你项目用的解释器一致 - 如果看到
/venv/、/env/或miniconda3/envs/xxx这类路径，说明环境对了；要是直接指向系统 Python，得先用python -m venv .venv创建虚拟环境，再用命令面板（Ctrl+Shift+P）选Python: Select Interpreter切过去 - 装库就一条命令：
pip install requests（把requests换成你要的库名），别加sudo，也别用python -m pip——除非你明确知道当前pip不是对应解释器的
pip install 报错 “PermissionError” 或 “Connection refused” 怎么办
前者多因误用了系统 Python（尤其 macOS 自带的），后者常是公司网络或国内源不稳定导致。VS Code 不会替你绕过这些底层限制，得手动干预。
- 优先换国内源：在命令里加
-i https://pypi.tuna.tsinghua.edu.cn/simple/，比如pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 如果仍报权限错，说明你没在虚拟环境中——立刻停手，别用
sudo pip install，那会污染系统环境，后面所有项目都可能出问题 - 检查
pip --version输出里的 Python 路径，跟python --version的路径是否一致；不一致就用python -m pip install xxx强制走当前解释器的 pip
装完库却提示 “ModuleNotFoundError”，环境可能没对齐
VS Code 可能开着多个 Python 解释器，终端、调试器、语言服务器各自记一个环境，改了一个地方，其他地方未必同步。
- 看左下角状态栏：有没有显示类似
Python 3.11.5 ('venv': venv)的信息？没显示或显示不对，说明解释器没选准 - 重启 VS Code 终端：关掉所有终端标签页，再按
Ctrl+`新开一个，它才会读取最新选中的解释器 - 检查
settings.json里有没有硬编码的python.defaultInterpreterPath，如果路径已经删了虚拟环境，这个配置会让 VS Code 死磕一个不存在的解释器 - 在代码里加一行
import sys; print(sys.executable)，运行看看路径，跟终端里which python对比，不一致就得重新选解释器
想批量装库？别直接 pip install -r requirements.txt
这条命令本身没问题，但容易漏掉前提：requirements.txt 是为哪个 Python 版本写的？里面有没有平台相关依赖（比如 pywin32）？VS Code 不会自动帮你做兼容性判断。
立即学习“Python免费学习笔记（深入）”；
- 先确认当前解释器版本满足要求：比如
requirements.txt开头有# python >= 3.9，而你选的是 3.8，装完也可能运行报错 - 某些库在 Windows/macOS 上名字不同（如
pywin32vspyobjc），文件里如果没用条件标记（platform_system == "Windows"），直接装可能失败 - 推荐加个
--no-deps先试装主库：pip install -r requirements.txt --no-deps，成功后再逐个装依赖，方便定位冲突
装库这事，本质是让终端、解释器、VS Code 状态三者对齐。最容易被忽略的，是每次换项目后忘记重选解释器，或者以为“点了运行就等于环境就绪”。其实 VS Code 从不替你记住上下文，它只忠实地执行你当前选中的那个 Python。
