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)
      开头,表示你已经进入了虚拟环境。

      元典智库
      元典智库

      元典智库:智能开放的法律搜索引擎

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

339

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

416

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

761

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

351

2025.07.23

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

810

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1129

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

804

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

454

2023.08.02

2026赚钱平台入口大全
2026赚钱平台入口大全

2026年最新赚钱平台入口汇总,涵盖任务众包、内容创作、电商运营、技能变现等多类正规渠道,助你轻松开启副业增收之路。阅读专题下面的文章了解更多详细内容。

54

2026.01.31

热门下载

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

精品课程

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

共28课时 | 3.7万人学习

Kotlin 教程
Kotlin 教程

共23课时 | 3.1万人学习

SQL 教程
SQL 教程

共61课时 | 3.6万人学习

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

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