在 VS Code 中创建 Python 虚拟环境,推荐优先使用官方 Python 扩展自带的图形化向导一键完成。整个过程无需手动敲命令,扩展会自动激活虚拟环境并绑定解释器,是最不容易出错的方式。
安装Python扩展
打开vscode,找到扩展,搜索python,点击install,我本地已经安装了,所以显示的是uninstall(卸载)
安装虚拟环境
1、先打开你的项目
以「文件夹模式」打开你的项目根目录,而非仅打开单个.py文件,如下图所示,我构建了一个project文件夹,里面有一个test.py,打开整个project
2、按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)调出命令面板,选择 Python: Create Environment。
3、选「Venv」环境类型,指定系统已有的Python版本
按照上述步骤操作后,项目根目录下会出现一个 .venv 文件夹,说明 Python 虚拟环境已经配置完成。### 4、验证虚拟环境是否生效
按 Ctrl + ` 打开终端,如果项目路径前出现(.venv),说明虚拟环境已经生效。此时安装的各种模块都会直接安装到 .venv 虚拟环境中,不用担心污染本地的 Python 环境。
安装模块示例:例如执行 pip install gradio,可以看到该模块被直接安装到了 .venv 环境中。
异常处理
虚拟环境安装完成后,验证是否可用时,可能出现类似下图的异常
这个报错是 Windows PowerShell 的一项安全机制导致的,它默认禁止运行脚本以防止潜在风险。要解决这个问题,你需要修改 PowerShell 的执行策略。
1、以管理员身份打开 PowerShell
- 在 Windows 搜索栏中输入 PowerShell
- 在搜索结果中右键点击“Windows PowerShell”,选择“以管理员身份运行”。
2、执行命令
- 在打开的管理员 PowerShell 窗口中,输入以下命令并按回车:
Set-ExecutionPolicyRemoteSigned- 系统会提示你确认,输入 Y 或 A 然后按回车即可。
3、重启 VS Code
- 关闭并重新打开 VS Code,然后再次尝试打开终端,虚拟环境应该就能正常激活了。