Python Poetry项目VS Code语言功能失效，Pylance无法识别依赖求助

排查解决步骤 #

• 确认虚拟环境路径并重新选择解释器

  1. 在项目根目录终端运行 poetry env info --path，复制输出的虚拟环境路径
  2. 打开VS Code命令面板（Ctrl+Shift+P/Command+Shift+P），输入 Python: Select Interpreter，找到对应路径下的Python解释器，重新选中（哪怕之前选过，再确认一次）

• 重启Pylance服务并清理缓存

  1. 打开命令面板，输入 Python: Restart Language Server，重启Pylance服务
  2. 如果无效，手动删除Pylance缓存：
     • Windows：删除 %USERPROFILE%\.vscode\extensions\ms-python.vscode-pylance-*\dist\pyright 文件夹
     • macOS/Linux：删除 ~/.vscode/extensions/ms-python.vscode-pylance-*/dist/pyright 文件夹
     • 删除完成后重启VS Code

• 验证依赖是否正确安装

  1. 在终端运行 poetry install，确保所有依赖都安装到虚拟环境中
  2. 运行 poetry run python -c "import 你的依赖包名"，测试依赖能否正常导入，排除安装失败的问题

• 配置项目级Python路径
  在项目的 .vscode/settings.json 里添加以下配置（替换成你的虚拟环境路径）：

  {
    "python.pythonPath": "/path/to/venv/bin/python", // macOS/Linux环境使用
    // Windows环境替换为："\\path\\to\\venv\\Scripts\\python.exe"
  }
  

附Pylance日志信息 #

2025-08-03 08:25:50.202 [info] (6995) Auto-excluding **/node_modules
2025-08-03 08:25:50.202 [info] (6995) Auto-excluding **/__pycache__
2025-08-03 08:25:50.202 [info] (6995) Auto-excluding **/.*
2025-08-03 08:25:50.202 [info] (6995) Assuming Python version 3.11.10.final.0
2025-08-03 08:25:50.293 [info] (6995) Found 3 source files

内容的提问来源于stack exchange，提问作者Mikko Ohtamaa