vs code中python库导入失败的核心原因是解释器路径、sys.path与pylance索引范围未对齐：需通过“python: select interpreter”选定正确环境（如.venv），在集成终端确认激活状态及python路径一致，用pip --version验证，并配置python.analysis.extrapaths确保模块路径被索引。
确认当前 Python 解释器是不是你想要的那个
VS Code 里能装一堆 Python，但代码运行时只认一个解释器——如果它指向系统全局 Python，pip install 装的库就可能“看不见”；如果指向虚拟环境却没激活，又会报 ModuleNotFoundError。这不是 VS Code 的 bug，是解释器路径没对上。
- 按
Ctrl+Shift+P，输入Python: Select Interpreter，选带.venv或venv字样的路径（Windows 是venv\Scripts\python.exe，macOS/Linux 是venv/bin/python） - 打开集成终端（
Ctrl+`），看提示符开头有没有括号包着的环境名，比如(venv)—— 没有就说明没激活，得手动运行激活命令 - 在终端里输
which python（macOS/Linux）或where python（Windows），输出路径应和你在Select Interpreter里选的一致
用 pip 安装库前先确保环境干净且可写
很多人输完 pip install requests 看似成功，一运行就报错，其实是 pip 把库装到了别的 Python 下，或者权限不足导致部分文件没写进去。
- 终端里先运行
pip --version，确认输出的 Python 路径和解释器路径一致 - 别跳过虚拟环境：项目根目录下执行
python -m venv .venv创建，再激活，再装库——这是隔离依赖最稳的方式 - 如果遇到
PermissionError或Access is denied，别加sudo或右键管理员运行，而是检查是否误用了系统 Python；换成虚拟环境基本就绕开所有权限问题
导入失败？先查 VS Code 的 Python 分析路径有没有漏掉
即使库已安装、解释器也选对了，import 仍标红、补全不出现、跳转失效——大概率是 VS Code 的语言服务器（Pylance）没扫描到那个库的位置。
- 检查项目根目录下的
.vscode/settings.json，确认有没有这行："python.analysis.extraPaths"；如果有，确保路径写对，比如["./libs"]就得真有./libs/xxx.py - 如果用了子模块结构（比如
src/utils/http_client.py），而主程序在项目根目录，VS Code 默认不会把src当作包路径；这时加"python.defaultInterpreterPath"不管用，得靠extraPaths或在src下放一个空的__init__.py - 改完设置后，重启 VS Code 或按
Ctrl+Shift+P→Python: Restart Language Server，否则缓存还在骗你
requirements.txt 不是摆设，但得用对时机
有人把 requirements.txt 当成“一键安装清单”，却忘了它只是快照——版本锁死是优点也是陷阱，尤其当你想升级某个库却卡在依赖冲突里。
- 生成它用：
pip freeze > requirements.txt（仅在激活的虚拟环境中运行） - 安装它用：
pip install -r requirements.txt，不是pip install requirements.txt（后者会当成库名去 PyPI 找） - 如果团队协作，建议删掉
pip freeze生成的哈希值（如pkg-resources==0.0.0这种），它们只在特定构建环境下有效，反而容易引发 CI 失败
import 的，永远是解释器路径、sys.path 和 Pylance 的索引范围——这三个地方只要有一个没对齐，就会卡在“明明装了却用不了”。 
