VSCode设置Python虚拟环境(隔离开发，项目管理必备)-VSCode-PHP中文网

VSCode设置Python虚拟环境(隔离开发，项目管理必备)

看不見的法師

发布： 2025-08-12 19:05:01

原创

363人浏览过

在vscode中设置python虚拟环境是为了隔离项目依赖、避免版本冲突，首先确保已安装python 3.6+和vscode，然后创建项目文件夹并用vscode打开，通过终端命令python3 -m venv .venv创建虚拟环境，再根据操作系统运行source .venv/bin/activate（macos/linux）或.venv\scripts\activate（windows）激活环境，接着在vscode命令面板中选择“python: select interpreter”并指定虚拟环境中的解释器路径，之后使用pip install安装所需包，并通过pip freeze > requirements.txt生成依赖列表以便后续复现环境，若vscode未自动激活虚拟环境，可检查python插件设置、使用.env文件配置环境变量或重启编辑器解决，而.venv文件夹可以删除，但删除后需重新创建虚拟环境并安装依赖，建议保留或通过清理缓存方式管理。

VSCode设置Python虚拟环境(隔离开发，项目管理必备)

设置 Python 虚拟环境，在 VSCode 中其实是为了更好地管理项目依赖，避免不同项目之间的库版本冲突。简单来说，就是给每个项目创建一个独立的空间，互不干扰。

解决方案（直接输出解决方案即可）

安装 Python 和 VSCode: 确保你的电脑上已经安装了 Python 和 VSCode。Python 建议安装 3.6 以上版本。
创建项目文件夹: 为你的项目创建一个新的文件夹，例如
```
my_project
```
登录后复制
。

立即学习“Python免费学习笔记（深入）”；
打开 VSCode 并进入项目文件夹: 在 VSCode 中打开你刚刚创建的项目文件夹。
创建虚拟环境:
- 打开 VSCode 的终端 (View -> Terminal)。
- 在终端中，使用以下命令创建虚拟环境：
```
python3 -m venv .venv  # 推荐，使用 venv 模块
# 或者
# virtualenv .venv  # 如果你安装了 virtualenv
```
  登录后复制
  这会在你的项目文件夹下创建一个名为
  .venv
  登录后复制
  登录后复制
  登录后复制
  登录后复制
  登录后复制
  登录后复制
  的文件夹（你可以自定义名字，但以
```
.
```
  登录后复制
  开头是约定俗成的做法，表示隐藏文件夹）。这个文件夹包含了独立的 Python 解释器和 pip。
激活虚拟环境:
- Windows:
```
.venv\Scripts\activate
```
  登录后复制
- macOS/Linux:
```
source .venv/bin/activate
```
  登录后复制
  激活后，你的终端提示符会变成
```
(.venv)
```
  登录后复制
  开头，表示你已经进入了虚拟环境。
在 VSCode 中选择虚拟环境:
- 打开 VSCode 的命令面板 (View -> Command Palette... 或者 Ctrl+Shift+P / Cmd+Shift+P)。
- 输入 "Python: Select Interpreter" 并选择它。
- VSCode 会自动检测到你的虚拟环境
```
.venv/bin/python
```
  登录后复制
  (或者
```
.venv/Scripts/python.exe
```
  登录后复制
  在 Windows 上)。选择这个解释器。
- 如果 VSCode 没有自动检测到，你可以手动输入解释器路径。
安装项目依赖:
- 在激活的虚拟环境中，使用
```
pip
```
  登录后复制
  安装你的项目依赖。例如：
```
pip install requests flask
```
  登录后复制
  这些依赖会被安装到
  .venv
  登录后复制
  登录后复制
  登录后复制
  登录后复制
  登录后复制
  登录后复制
  文件夹中，不会影响全局 Python 环境。
创建
```
requirements.txt
```
登录后复制
登录后复制
文件:
- 为了方便其他人或者在其他机器上部署你的项目，你可以创建一个
```
requirements.txt
```
  登录后复制
  登录后复制
  文件，记录你项目的所有依赖。
```
pip freeze > requirements.txt
```
  登录后复制
- 以后，你可以使用
```
pip install -r requirements.txt
```
  登录后复制
  登录后复制
  来安装所有依赖。
取消激活虚拟环境:
- 当你不再需要使用虚拟环境时，可以在终端中输入
```
deactivate
```
  登录后复制
  来取消激活。

如何解决 VSCode 不自动激活虚拟环境的问题？

有时候，VSCode 可能不会自动激活虚拟环境。这通常是因为 VSCode 的 Python 插件没有正确配置。

检查 Python 插件设置: 确保 VSCode 的
```
python.pythonPath
```
登录后复制
设置指向了你的虚拟环境中的 Python 解释器。你可以在 VSCode 的设置 (File -> Preferences -> Settings) 中搜索 "python.pythonPath" 来找到这个设置。
使用
.env
登录后复制
登录后复制
文件: 你可以在项目根目录下创建一个
```
.env
```
登录后复制
登录后复制
文件，并在其中设置
```
PYTHONPATH
```
登录后复制
环境变量，指向你的虚拟环境。例如：
```
PYTHONPATH=${workspaceFolder}/.venv/bin
```
登录后复制
这可以帮助 VSCode 自动识别虚拟环境。
重启 VSCode: 有时候，重启 VSCode 可以解决一些奇怪的问题。

虚拟环境

.venv

登录后复制

文件夹可以删除吗？

可以删除，但要谨慎。

.venv

登录后复制

文件夹包含了你项目的所有依赖。如果你删除了它，你的项目将无法运行，除非你重新安装所有依赖。

何时可以删除: 当你不再需要这个项目，或者你想要创建一个全新的虚拟环境时，可以删除
.venv
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
文件夹。
删除后的操作: 删除后，你需要重新创建虚拟环境并安装所有依赖 (使用
```
pip install -r requirements.txt
```
登录后复制
登录后复制
)。
更好的做法: 如果你只是想清理虚拟环境，可以尝试使用
```
pip cache purge
```
登录后复制
来清理 pip 的缓存，或者使用
```
pip uninstall -r requirements.txt
```
登录后复制
卸载所有依赖，然后再重新安装。这比直接删除
.venv
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
登录后复制
文件夹更安全。