VSCode怎么配置Python虚拟环境(venv)-VSCode-PHP中文网

vscode必须手动指定venv解释器路径，不能自动识别：windows选./.venv/scripts/python.exe，macos/linux选./.venv/bin/python；路径须为相对路径、指向python可执行文件本身，且需同步配置python.terminal.activateenvironment为true并重启vscode验证sys.executable。

vscode怎么配置python虚拟环境(venv)

VSCode不会自动使用你创建的venv，必须手动指定解释器路径——选错、漏选或路径写成绝对路径，都会导致补全失效、ModuleNotFoundError、调试跑错环境。

Python: Select Interpreter 选什么路径？

VSCode只认解释器可执行文件本身，不是整个venv文件夹。路径必须是相对于工作区根目录的相对路径，且指向python二进制文件：

Windows：./.venv/Scripts/python.exe（不是activate.bat，也不是python软链接）
macOS/Linux：./.venv/bin/python（不是activate脚本，也不是python3符号链接）
如果用venv而非.venv，路径对应为./venv/Scripts/python.exe或./venv/bin/python
路径里不能含空格或中文，否则Pylance可能解析失败；建议统一用.venv，Git和VSCode默认忽略它

为什么`python -m venv .venv`后VSCode还是找不到？

VSCode不递归扫描，只检查项目根目录下几个固定名（.venv、venv、env），且要求结构完整。常见失效原因：

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

.venv不在当前VSCode打开的**文件夹根目录**下（比如你在子目录里运行了python -m venv .venv）
创建时用了非标准命令，如virtualenv .venv——VSCode对venv模块生成的环境兼容性最好
在WSL中创建但VSCode运行在Windows端，路径/home/user/project/.venv无法直接访问，需用\wsl$...前缀或改在WSL中启动VSCode
创建后没立刻选解释器，而是先装包——VSCode可能误把系统Python当作默认，之后再选也容易缓存旧状态

终端不自动激活？`python.defaultInterpreterPath`和`python.terminal.activateEnvironment`要配齐

选对解释器只是第一步。VSCode的集成终端默认不激活虚拟环境，pip install仍可能装到全局。必须确认两个设置：

python.defaultInterpreterPath已在.vscode/settings.json中正确写入（如"./.venv/bin/python"）
python.terminal.activateEnvironment设为true（默认是true，但有时被用户级设置覆盖）
改完设置后重启VSCode——Pylance会缓存旧环境的类型信息，不重启补全仍不准
Jupyter Notebook的kernel是独立配置的，右上角kernel下拉菜单必须手动选匹配的.venv环境，和编辑器解释器无关

验证是否真生效：别信状态栏，要看`sys.executable`

状态栏显示Python 3.x ('.venv': venv)只是表面，真正判断依据是运行时实际加载的解释器：

新建test.py，内容为import sys; print(sys.executable)，运行它——输出必须含.venv路径
在集成终端中执行pip list，应只有pip、setuptools、wheel，没有你全局安装的包（如requests）
如果import requests报错，但pip install requests后就能导入，说明隔离成功；若仍报错，大概率是PYTHONPATH被手动污染或launch.json里没配"env": {"PYTHONPATH": "${workspaceFolder}"}