VS Code创建虚拟环境报错CREATE_VENV.VENV_NOT_FOUND如何解决？

问题场景 #

使用VS Code（v1.84.2）及Python扩展（v2023.20.0），按以下步骤创建虚拟环境：

• 按下Ctrl-Shift-P打开命令面板；
• 选择“Python: Create Environment...”；
• 选择“Venv”作为环境类型；
• 选择“Python 3.12.0 64-bit”作为Python安装版本。

执行后触发错误：

CREATE_VENV.VENV_NOT_FOUND

相关日志输出：

2023-11-22 09:25:10.912 [info] Selected workspace c:\Users\ME\source\python_projects\python-testing for creating virtual environment.
2023-11-22 09:25:14.752 [info] Selected interpreter C:\Users\ME\source\python\python.exe for creating virtual environment.
2023-11-22 09:25:14.833 [info] Running Env creation script:  [
  'C:\\Users\\ME\\source\\Developers\\Projects\\python\\python.exe',
  'c:\\Users\\ME\\.vscode\\extensions\\ms-python.python-2023.20.0\\pythonFiles\\create_venv.py',
  '--git-ignore'
]
2023-11-22 09:25:14.833 [info] > ~\source\python\python.exe ~\.vscode\extensions\ms-python.python-2023.20.0\pythonFiles\create_venv.py --git-ignore
2023-11-22 09:25:14.833 [info] cwd: .
2023-11-22 09:25:15.255 [info] Traceback (most recent call last):
  File "c:\Users\ME\.vscode\extensions\ms-python.python-2023.20.0\pythonFiles\create_venv.py", line 250, in <module>
2023-11-22 09:25:15.256 [info]     main(sys.argv[1:])
  File "c:\Users\ME\.vscode\extensions\ms-python.python-2023.20.0\pythonFiles\create_venv.py", line 185, in main
    raise VenvError("CREATE_VENV.VENV_NOT_FOUND")
VenvError: CREATE_VENV.VENV_NOT_FOUND
2023-11-22 09:25:15.291 [error] Error while running venv creation script:  CREATE_VENV.VENV_NOT_FOUND
2023-11-22 09:25:15.292 [error] CREATE_VENV.VENV_NOT_FOUND

解决方法 #

1. 验证Python的venv模块是否存在 #

打开系统命令提示符，执行以下命令：

python -m venv --help

如果提示“找不到模块”，说明当前Python安装缺少venv组件。需重新安装Python：

• 勾选“Add Python to PATH”选项；
• 自定义安装时确认勾选“venv”组件；
• 确保选中“Install launcher for all users”和“Add Python to environment variables”。

2. 手动创建虚拟环境 #

跳过VS Code的自动流程，直接在终端执行命令：

1. 进入项目目录：

cd c:\Users\ME\source\python_projects\python-testing

2. 手动创建虚拟环境：

C:\Users\ME\source\python\python.exe -m venv .venv

3. 创建完成后，在VS Code中按Ctrl-Shift-P，选择“Python: Select Interpreter”，选中.venv\Scripts\python.exe即可。

3. 检查VS Code扩展设置 #

• 打开VS Code设置（快捷键Ctrl+,），搜索“Python: Venv Path”，确认路径设置正确，或重置为默认值；
• 将Python扩展更新至最新版本，修复已知兼容性问题。

4. 确认目录权限 #

• 右键项目文件夹→属性→安全，确保当前用户拥有“修改”和“写入”权限；
• 若使用管理员账户，尝试以管理员身份启动VS Code后再创建环境。

内容的提问来源于stack exchange，提问作者user2148983