VSCode中正确配置Python虚拟环境需三步：一是在项目根目录运行python -m venv .venv创建环境；二是通过命令面板选择对应解释器路径并确认状态栏显示；三是配置终端自动激活，验证sys.executable路径含.venv且pip list仅显示基础包。
在 VSCode 中正确配置 Python 虚拟环境，关键不是“创建完就完事”，而是让编辑器真正识别、激活并持续使用它——包括解释器选择、终端自动激活、以及避免常见路径和权限陷阱。
创建虚拟环境要指定明确路径
不要依赖默认位置（比如项目根目录下无名的 venv），容易混淆或被误删。推荐统一放在项目内的 .venv 文件夹：
- 终端中运行：
python -m venv .venv（Windows/macOS/Linux 均适用） - 确保当前目录是你的项目根目录，
.venv会自动创建且被 VSCode 默认忽略（因以点开头） - 如果提示“找不到 python 命令”，说明系统没配好 Python 路径，先运行
where python（Win）或which python3（macOS/Linux）确认可执行文件位置
手动指定 VSCode 使用的 Python 解释器
VSCode 不会自动切换到你刚建的虚拟环境，必须手动选一次，之后才生效：
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入 Python: Select Interpreter - 在列表中找到类似
./.venv/bin/python（macOS/Linux）或.\.venv\Scripts\python.exe（Windows）的路径并选择 - 状态栏左下角会显示当前解释器路径，确认它指向
.venv内部 - 选完后，VSCode 会自动在工作区生成
.vscode/settings.json，写入"python.defaultInterpreterPath"，这是项目级配置，团队协作时建议提交该文件
让集成终端自动激活虚拟环境
否则每次打开新终端都要手动运行 source .venv/bin/activate（macOS/Linux）或 .venv\Scripts\activate（Windows），很麻烦：
立即学习“Python免费学习笔记（深入）”；
- 打开设置（
Ctrl+,），搜索 Python: Terminal Execute In File Dir，勾选它 - 再搜索 Python: Default Interpreter Path，确认值与上面选的一致
- 更关键的是：在用户或工作区设置中添加：
"python.terminal.launchArgs": ["-WorkingDirectory", "${workspaceFolder}"]（仅 Windows PowerShell 用户需额外配置） - 重启终端（
Ctrl+Shift+`关闭再打开），应该看到提示符前带(.venv)，表示已激活
验证是否真正生效
别只看状态栏，实际测一下最可靠：
- 新建一个
test.py，写import sys; print(sys.executable)，运行它——输出路径应包含.venv - 在集成终端中运行
pip list，只看到基础包（如 pip、setuptools），没有全局安装的第三方库 - 用
pip install requests安装一个包，再在 Python 文件中import requests，不报错即成功 - 如果仍提示
ModuleNotFoundError，大概率是解释器没选对，或终端没激活，回头检查前两步
基本上就这些。不复杂但容易忽略细节——尤其是解释器选择和终端激活这两步，缺一不可。
