VSCode - 设置Python venv

Python environments in VS Code

#创建Python venv

1, 在扩展插件里搜索“Python”并安装，支持python语言开发的相关功能。

2, 在微软的应用商店里选择安装相应版本的Python，或者下载官网所需版本的安装文件来安装。

C:\Users\me>where python

C:\Users\me\AppData\Local\Microsoft\WindowsApps\python.exe

C:\Users\me>python

Python 3.13.3 (tags/v3.13.3:6280bb5, Apr 8 2025, 14:47:33) [MSC v.1943 64 bit (AMD64)] on win32

Type "help", "copyright", "credits" or "license" for more information.

>>>

3, VSCode打开一个文件夹来创建workspace，然后通过Python的Create ENV命令创建Python ENV。

选择刚安装的Python版本，就会在当前工程目录下生成一个.venv的python虚拟环境。

Open the Command Palette (Ctrl+Shift+P), start typing the Python: Create Environment command to search, and then select the command.

The command presents a list of environment types, Venv or Conda. For this example, select Venv.

4, 使用命令行模式也可以创建VENV的。

mkdir myproject && cd myproject

python -m venv .venv        # 环境目录与项目同级

# .venv 名字可以改为myenv等其他名称

5, 激活python venv。

使用Windows CMD进入此VENV目录，运行Scripts/activate，激活venv。

使用power shell，则需要执行Scripts/Activate.ps1。

示例如下：

source .venv/bin/activate   # 激活环境 Linux

.venv\Scripts\activate # 激活（Windows）

venv激活后，安装需要的库：

python -m pip install <package_name> / <*.whl>

# VSCode中进行设置

1，上面创建了venv后，可以在VSCode设置其作为python解释器。

在命令行中输入：>Python: Select Interpeter，会出现可选列表。

或者在底部状态栏，点击右小角后出现列表，需要当前打开的是py文件。

2，列表中可选择已有的venv，比如使用VSCode创建的。

或者可以选择Enter interpreter path，手动定位python.exe。

还可以通过设置python.defaultInterpreterPath，启动时默认指定的python.exe文件路径。

3, "python.terminal.activateEnvironment":true, 在打开一个终端时，自动激活python venv。

4，Python扩展查询venv的路径顺序：

> Standard install paths

> workspace (project) folder

> python.venvPath setting (first-level subfolders of venvPath)

注：

1, For Debian-based OS, if no venv, please install python3-venv.

2, Conda is like venv. It is installed with Miniconda. It can be used to manage both packages and virtual environments. Generally used for data science projects.