在 VS Code 中创建 Python 虚拟环境是隔离项目依赖的最佳实践,可防止不同项目之间的库冲突。以下是创建步骤的综合指南,基于多个最新来源总结而成。确保已安装 Python(推荐 Python 3.3+)和 VS Code Python 扩展。
1. 创建虚拟环境
- 在项目文件夹中,启动 VS Code 终端(快捷键
Ctrl+Shift+
或点击菜单栏 Terminal → New Terminal)。 - 运行以下命令
python -m venv .venv
.venv
为名,可自定义): - 其中:
python
:调用 Python 解释器(如使用 Python 3,可用python3
)。-m venv
:指定内置虚拟环境模块。.venv
:虚拟环境文件夹名称,通常创建为隐藏目录。2. 激活虚拟环境
- Windows 系统:在终端运行:
.\.venv\Scripts\activate
(.venv)
表示成功 。 - macOS/Linux 系统:在终端运行:
source .venv/bin/activate
同样观察提示符变化确认激活 。
3. 配置 VS Code 使用虚拟环境
- 激活虚拟环境后,在 VS Code 中设置 Python 解释器:
- 打开命令面板(快捷键
Ctrl+Shift+P
或Cmd+Shift+P
)。 - 输入并选择
Python: Select Interpreter
。 - 从列表中选择虚拟环境的解释器(如
.venv\Scripts\python.exe
on Windows 或.venv/bin/python
on macOS/Linux) 。 - VS Code 会自动识别虚拟环境,右下角状态栏显示环境名称 。
- tips:这里存在选择Select Interpreter后找不到虚拟环境所在目录的情况,需要手动把当前的目录设置为workplace即可
- 打开命令面板(快捷键
4. 可选设置:自动激活虚拟环境
- 在 VS Code 中,按
Ctrl+,
打开设置,搜索Python Terminal Activate Env
,确保勾选Python > Terminal: Activate Environment
选项。 - 此设置使新开终端时自动激活当前虚拟环境