如何在VSCode中配置Python虚拟环境以识别本地安装模块？

问题根源 #

你手动导航选择的bin文件夹中的Python程序是指向全局Python的符号链接，而非虚拟环境专属的解释器，导致VSCode实际上仍在使用全局环境。

解决方案 #

1. 确认虚拟环境的正确解释器路径 #

用命令行创建的虚拟环境，其专属解释器路径应为./bin/python（若你在当前目录执行python3.11 -m venv .），这个文件并非全局Python的链接，而是虚拟环境独立的解释器。如果你的该文件是全局链接，建议重新创建虚拟环境：

# 改用明确的环境名，避免在当前根目录创建可能引发的路径问题
python3.11 -m venv my_venv
source my_venv/bin/activate
python -m pip install NAME_OF_MODULE

2. 正确选择VSCode解释器 #

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），执行Python: Select Interpreter
• 在列表中直接选择带有你虚拟环境名称（比如my_venv）的选项，VSCode会自动识别环境路径，无需手动导航到bin文件夹
• 若列表未显示目标环境，点击Enter interpreter path，导航到my_venv/bin/python（注意选择的是虚拟环境内的可执行文件，而非全局链接）

3. 验证环境是否生效 #

• 打开VSCode终端，查看前缀是否带有虚拟环境名称（如(my_venv)），若没有则手动执行source my_venv/bin/activate
• 在终端执行pip list，确认你安装的模块存在
• 运行代码测试模块导入

4. 关于VSCode的Python: Create Environment #

不需要必须使用该功能，命令行创建的虚拟环境完全兼容VSCode，只需确保选对解释器即可。虚拟环境内的包安装仍遵循常规流程：激活环境后执行pip install即可，官方文档未单独提及是因为这属于通用操作。

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