VS Code如何配置Poetry的.venv环境解决Pylint E0401导入错误？

步骤1：手动指定虚拟环境解释器 #

VS Code自动扫描可能遗漏项目内的.venv，需手动指定路径：

• 按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板
• 输入Python: Select Interpreter，选择「Enter interpreter path...」
• 导航到项目根目录：
  • Linux/Mac：选中.venv/bin/python
  • Windows：选中.venv\Scripts\python.exe

步骤2：配置VS Code的Python设置 #

在项目的.vscode/settings.json中添加以下配置（根据系统调整路径），确保VS Code锁定虚拟环境：

{
  "python.pythonPath": "${workspaceFolder}/.venv/bin/python",
  "python.venvPath": "${workspaceFolder}/.venv"
}

Windows系统需将路径改为${workspaceFolder}/.venv/Scripts/python.exe

步骤3：关联虚拟环境内的Pylint #

避免Pylint使用全局版本，需指定虚拟环境中的Pylint：

• 打开命令面板，输入Python: Select Linter并选择pylint
• 在.vscode/settings.json中添加Pylint路径配置：

"python.linting.pylintPath": "${workspaceFolder}/.venv/bin/pylint"

Windows系统改为${workspaceFolder}/.venv/Scripts/pylint.exe

步骤4：重启Python语言服务 #

完成以上配置后，刷新VS Code的语言服务生效：

• 命令面板输入Python: Restart Language Server，等待服务重启后，Pylint的导入错误会自动消失

优化技巧（可选） #

运行以下Poetry命令，让后续创建的虚拟环境默认放在项目根目录，VS Code可自动识别：

poetry config virtualenvs.in-project true

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