在 VSCode 中即使已设置 Python 虚拟环境,仍出现波浪线(通常是 Pylance 语言服务器的“未解析导入”警告),这并非代码错误,而是静态分析工具未能正确识别当前解释器所对应的包路径。以下是系统性的解决方案:
✅ 第一步:确认并选择正确的 Python 解释器
这是最常见的原因。VSCode 可能默认使用了全局 Python 或其他环境,而非你期望的虚拟环境。
- 按
Ctrl + Shift + P打开命令面板。 - 输入并选择 Python: Select Interpreter
- 在弹出的列表中,找到你的虚拟环境路径(通常包含
.venv、venv或env等字样)。- 例如:
.venv\Scripts\python.exe(Windows) 或.venv/bin/python(macOS/Linux)
- 例如:
- 选中它,VSCode 右下角状态栏会显示当前选中的解释器路径。
💡 如果列表中没有你的虚拟环境,说明 VSCode 没有自动扫描到它。你可以点击 “Enter interpreter path…” 手动输入完整路径。
✅ 第二步:重启语言服务器以刷新缓存
有时即使选择了正确的解释器,Pylance 仍会缓存旧的路径信息。
- 按
Ctrl + Shift + P - 输入并执行 Developer: Reload Window
- 等待几秒,让 VSCode 重新加载并初始化语言服务器。