0

0

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

看不見的法師

看不見的法師

发布时间:2025-08-12 19:05:01

|

790人浏览过

|

来源于php中文网

原创

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 中其实是为了更好地管理项目依赖,避免不同项目之间的库版本冲突。简单来说,就是给每个项目创建一个独立的空间,互不干扰。

解决方案(直接输出解决方案即可)

  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:
      .venv\Scripts\activate
    • macOS/Linux:
      source .venv/bin/activate

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

      (.venv)
      开头,表示你已经进入了虚拟环境。

      CodiumAI
      CodiumAI

      AI代码测试工具,在IDE中获得重要的测试建议

      下载
  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
    文件夹更安全。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

775

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

684

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

768

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

719

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1445

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

571

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

751

2023.08.11

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

58

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 教程
Django 教程

共28课时 | 3.5万人学习

Kotlin 教程
Kotlin 教程

共23课时 | 2.8万人学习

SQL 教程
SQL 教程

共61课时 | 3.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号