VSCode 中即使已设置 Python 虚拟环境,仍出现波浪线解决办法

在 VSCode 中即使已设置 Python 虚拟环境,仍出现波浪线(通常是 Pylance 语言服务器的“未解析导入”警告),这并非代码错误,而是静态分析工具未能正确识别当前解释器所对应的包路径。以下是系统性的解决方案:


✅ 第一步:确认并选择正确的 Python 解释器

这是最常见的原因。VSCode 可能默认使用了全局 Python 或其他环境,而非你期望的虚拟环境。

  1. 按 Ctrl + Shift + P 打开命令面板。
  2. 输入并选择 Python: Select Interpreter
  3. 在弹出的列表中,找到你的虚拟环境路径(通常包含 .venvvenv 或 env 等字样)。
    • 例如:.venv\Scripts\python.exe (Windows) 或 .venv/bin/python (macOS/Linux)
  4. 选中它,VSCode 右下角状态栏会显示当前选中的解释器路径。

💡 如果列表中没有你的虚拟环境,说明 VSCode 没有自动扫描到它。你可以点击 “Enter interpreter path…” 手动输入完整路径。


✅ 第二步:重启语言服务器以刷新缓存

有时即使选择了正确的解释器,Pylance 仍会缓存旧的路径信息。

  1. 按 Ctrl + Shift + P
  2. 输入并执行 Developer: Reload Window
  3. 等待几秒,让 VSCode 重新加载并初始化语言服务器。