最直接的办法是在 VSCode 中手动切换 Python 解释器，确保状态栏显示的路径与你终端里运行 pip install 时的路径完全一致。
先说结论：Pylance 报错通常是因为编辑器使用的 Python 环境与代码实际运行的环境不一致。
- 先确认：终端里 python -c "import sys; print(sys.executable)" 的输出路径。
- 先处理：在 VSCode 命令面板执行 Python: Select Interpreter 选中同一路径。
- 再验证：观察 Pylance 日志是否不再报 unresolved import 且状态栏路径匹配。
命令速用版
VSCode 主要依赖图形界面操作，但可以通过命令面板快速触发解释器切换和缓存清理：
快捷键：Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (macOS)
关键命令：
- Python: Select Interpreter
- Python: Clear Cache and Reload Window
- Preferences: Open Settings (JSON)
为什么会这样
Pylance 是一个静态分析工具，它需要准确地知道你的代码所依赖的库具体安装在哪个路径下，才能提供智能提示。当你直接在终端输入 python 脚本时，操作系统会调用 PATH 环境变量里的那个 Python，或者你当前激活的虚拟环境中的 Python。但 Pylance 通常在 VSCode 启动时，或者你切换解释器后，一次性地加载所选解释器对应的环境路径。如果 Pylance 加载的环境路径和你实际安装包的环境路径不一致，它自然就看不到这个包。
分步处理
1. 确认终端环境路径
在 VSCode 的集成终端（确保它显示的是你的虚拟环境）里运行以下命令，记下输出的路径：
python -c "import sys; print(sys.executable)"2. 切换 VSCode 解释器
点击 VSCode 状态栏右下角的 Python 版本号，或在命令面板输入 Python: Select Interpreter，选择与上述路径一致的解释器。如果用了 pyenv、asdf 这类版本管理器，确保 PYTHONPATH 没被意外覆盖，且 VSCode 是通过 shell 命令启动的。
3. 检查额外路径配置
若自动识别失败，可手动编辑配置文件。打开命令面板，选择 Preferences: Open Settings (JSON)，检查或添加以下配置：
{
"python.analysis.extraPaths": [],
"python.defaultInterpreterPath": "${command:python.interpreterPath}"
}注意：python.analysis.extraPaths 留空即可，填了反而容易干扰。确认没有手动设 python.analysis.autoSearchPaths 为 false。
如果项目结构特殊（如 src 目录），可在工作区根目录添加 pyrightconfig.json 文件配置 extraPaths：
{
"executionEnvironments": [
{
"root": "src",
"extraPaths": ["src/lib"]
}
]
}4. 清理缓存
路径类配置变更后常缓存旧状态。在命令面板执行 Python: Clear Cache and Reload Window，或禁用并重新启用 Python 扩展。
怎么验证是否生效
查看 VSCode 右下角状态栏，必须看到带路径的 Python 版本号，且路径要和你运行 pip list 时用的 Python 一致。打开一个导入第三方库的 Python 文件，观察 Pylance 是否不再报红（unresolved import）。在输出面板选择 Python Language Server 通道，确认没有大量的错误日志。
常见坑
- 包名与导入名不一致：很多包安装名和 import 名不同，比如 pip install python-dotenv 但代码里写 import dotenv，Pylance 靠的是 import 语句里的名字。
- 相对导入报错：Pylance 对相对导入非常严格，要求文件必须处于一个被识别为包的上下文中，对应的目录结构里每一级都得有 __init__.py。
- 虚拟环境切换后没重载：虚拟环境切换后没重载 Pylance，也会卡在旧路径上。