VSCode Python虚拟环境配置教程（全平台一键激活终极指南）

在进行Python开发时，合理管理项目依赖是至关重要的。VSCode配置Python环境不仅能提升开发效率，还能有效避免全局环境污染。无论你是Windows用户，还是macOS/Linux用户，掌握Python虚拟环境激活的方法都是入门的第一步。

一、准备工作

首先，请确保你的电脑已经安装了 VSCode 和 Python。这篇 Venv教程 将直接进入实操环节。打开你的项目文件夹，并在 VSCode 中打开终端（快捷键：Ctrl + ` ）。

二、创建虚拟环境

在终端中输入以下命令来创建一个名为 .venv 的虚拟环境：

python -m venv .venv

执行完成后，你会发现项目目录下多了一个 .venv 文件夹，这就是你的独立运行空间。

VSCode Python虚拟环境配置教程（全平台一键激活终极指南） VSCode配置Python环境 Python虚拟环境激活 Venv教程 VSCode设置解析器第1张

三、关键：VSCode设置解析器

环境创建好了，但 VSCode 默认可能还在使用全局环境。这是最关键的一步：VSCode设置解析器。

按下 Ctrl + Shift + P (macOS 为 Cmd + Shift + P)。
搜索并选择 “Python: Select Interpreter”。
在列表中找到包含 (.venv) 字样的路径并点击。

完成后，VSCode 会自动在你的 .vscode/settings.json 中记录此配置，下次打开时将自动激活。

四、全平台激活指南（手动模式）

如果你需要在终端手动激活环境，请参考以下对应的平台指令：

Windows (PowerShell): .\.venv\Scripts\Activate.ps1
Windows (CMD): .\.venv\Scripts\activate.bat
macOS/Linux: source .venv/bin/activate

五、常见问题排查

如果在 Windows 上遇到“禁止运行脚本”的错误，请以管理员身份运行 PowerShell 并输入 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 即可解决。通过以上步骤，你已经成功掌握了VSCode配置Python环境的所有要点。

本文关键词总结：VSCode配置Python环境、Python虚拟环境激活、Venv教程、VSCode设置解析器