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

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

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

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

1. 安装 Python 和 VSCode: 确保你的电脑上已经安装了 Python 和 VSCode。Python 建议安装 3.6 以上版本。

2. 创建项目文件夹: 为你的项目创建一个新的文件夹，例如

   my_project

   。

   立即学习“Python免费学习笔记（深入）”；

3. 打开 VSCode 并进入项目文件夹: 在 VSCode 中打开你刚刚创建的项目文件夹。

4. 创建虚拟环境:

   • 打开 VSCode 的终端 (View -> Terminal)。
   • 在终端中，使用以下命令创建虚拟环境：

     python3 -m venv .venv  # 推荐，使用 venv 模块 # 或者 # virtualenv .venv  # 如果你安装了 virtualenv

     这会在你的项目文件夹下创建一个名为

     .venv

     的文件夹（你可以自定义名字，但以

     .

     开头是约定俗成的做法，表示隐藏文件夹）。这个文件夹包含了独立的 Python 解释器和 pip。

5. 激活虚拟环境:

   • Windows:

     .venvScriptsactivate
   • macOS/Linux:

     source .venv/bin/activate

     激活后，你的终端提示符会变成

     (.venv)

     开头，表示你已经进入了虚拟环境。

6. 在 VSCode 中选择虚拟环境:

   • 打开 VSCode 的命令面板 (View -> Command Palette… 或者 Ctrl+Shift+P / Cmd+Shift+P)。
   • 输入 “Python: Select Interpreter” 并选择它。
   • VSCode 会自动检测到你的虚拟环境

     .venv/bin/python

     (或者

     .venv/Scripts/python.exe

     在 Windows 上)。选择这个解释器。

   • 如果 VSCode 没有自动检测到，你可以手动输入解释器路径。

7. 安装项目依赖:

   • 在激活的虚拟环境中，使用

     pip

     安装你的项目依赖。例如：

     pip install requests flask

     这些依赖会被安装到

     .venv

     文件夹中，不会影响全局 Python 环境。

8. 创建

   requirements.txt

   文件:

   • 为了方便其他人或者在其他机器上部署你的项目，你可以创建一个

     requirements.txt

     文件，记录你项目的所有依赖。

     pip freeze > requirements.txt
   • 以后，你可以使用

     pip install -r requirements.txt

     来安装所有依赖。

9. 取消激活虚拟环境:

   • 当你不再需要使用虚拟环境时，可以在终端中输入

     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

  文件夹更安全。