pip 虚拟环境使用教程

AI (189) 2026-08-24 17:30:02

一、什么是虚拟环境?

 

简单来说,虚拟环境就像一个独立的“小房间” 。

你在电脑上写Python程序时,可能需要用到各种第三方的库(比如requests、flask、django等)。问题来了:

  • 项目A需要 requests 的 1.0 版本
  • 项目B需要 requests 的 2.0 版本

如果你直接安装在电脑系统里,只能装一个版本,另一个项目就没法用了。

虚拟环境就是解决这个问题的——它为每个项目创建一个独立的“小房间”,每个房间里都有自己的Python解释器和一套独立的库,互不干扰。

打个比方:虚拟环境就像每个项目都有自己的“工具箱” ,而不是所有人共用一个大工具箱。这样你给项目A装工具,完全不会影响项目B。

 

二、为什么需要用虚拟环境?

 

  • 依赖隔离:不同项目可以用不同版本的库,不会打架
  • 干净整洁:系统Python保持干净,不会越用越乱
  • 方便分享:可以通过 requirements.txt 文件把项目需要的库清单分享给别人
  • 便于部署:在服务器上可以一键安装所有依赖

 

三、准备工作:检查Python是否安装

 

打开终端(Windows上是“命令提示符”或“PowerShell”,Mac/Linux上是“终端”),输入以下命令:

python --version

或者 

python3 --version

如果显示类似 Python 3.x.x 的结果,说明Python已安装。虚拟环境需要Python 3.3及以上版本(Python 3.3+ 内置了venv模块)。

如果提示找不到命令,请先去 python.org 下载安装Python。

 

四、一步一步:创建和使用虚拟环境

 

第1步:创建项目文件夹

 

首先,在电脑上创建一个存放项目的文件夹(你可以用任何名字):

创建文件夹

mkdir my_project

进入文件夹

cd my_project

 

第2步:创建虚拟环境

 

在项目文件夹里运行以下命令:

python -m venv .venv

这条命令会在当前目录创建一个叫 .venv 的文件夹,里面就是你的虚拟环境。

💡 小提示:.venv 是虚拟环境文件夹的常用名字(前面的点让它在文件夹列表里隐藏,不会碍眼)。你也可以起别的名字,比如 myenv、venv 都行。

创建成功后,你的项目文件夹里会多出一个 .venv 文件夹,里面包含:

  • Python解释器的副本
  • 独立的 pip 工具
  • 一个干净的第三方库存放位置

 

 

第3步:激活虚拟环境

 

这是最关键的一步! 只有激活了虚拟环境,你安装的包才会装到“小房间”里,而不是装到系统里。

不同操作系统命令不同:

操作系统 激活命令
Windows (CMD) .venv\Scripts\activate.bat
Windows (PowerShell) .\.venv\Scripts\Activate.ps1
macOS / Linux source .venv/bin/activate

 

如何确认激活成功了?

看命令行提示符——前面会出现 (.venv) 字样:

Windows

(.venv) C:\my_project>

或 Linux

(.venv) $ 

看到这个 (.venv) 前缀,就说明你已经在虚拟环境里了!

 

第4步:在虚拟环境中安装包

 

激活之后,用 pip install 安装包,它会自动装到当前的虚拟环境里:

pip install requests          # 安装最新版
pip install requests==2.28.1  # 安装指定版本
pip install flask django      # 一次安装多个

 

第5步:导出依赖清单(非常重要!)

 

当你安装了一些包之后,可以用这个命令把当前环境里所有包的名称和版本号导出到一个文件里:

pip freeze > requirements.txt

这个 requirements.txt 文件就像一份“购物清单”,记录了你的项目需要哪些包以及它们的版本。

别人拿到你的项目后,只需要运行下面这条命令,就能一键安装所有依赖:

pip install -r requirements.txt

 

 

第6步:退出虚拟环境

 

工作完成后,输入以下命令退出虚拟环境:

deactivate

命令行前的 (.venv) 前缀会消失,说明已经回到系统环境了。

 

五、完整流程速查表

 

把上面的步骤串起来,日常工作流程就是:

# 1. 创建项目并进入
mkdir my_project && cd my_project
# 2. 创建虚拟环境
python -m venv .venv
# 3. 激活虚拟环境(Windows)
.venv\Scripts\activate.bat
# 或(Mac/Linux)
source .venv/bin/activate
# 4. 安装需要的包
pip install flask requests
# 5. 导出依赖清单
pip freeze > requirements.txt
# 6. 工作结束,退出
deactivate

下次再回来工作时,只需要:

cd my_project
source .venv/bin/activate   # 重新激活
# 然后继续写代码、装包...

 

六、其他常用命令

 
用途 命令
查看已安装的包 pip list
卸载某个包 pip uninstall 包名
查看某个包的信息 pip show 包名
删除整个虚拟环境 直接删除 .venv 文件夹

 

七、新手常见问题

 

Q1:Linux上提示找不到 venv 模块怎么办?

 

在 Ubuntu/Debian 系统上,需要单独安装:

sudo apt install python3-venv

 

Q2:Windows上激活失败怎么办?

 

如果 PowerShell 提示“无法加载脚本”,可以用管理员身份运行 PowerShell,然后执行:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

然后再试一次激活命令。或者直接用 CMD(命令提示符)来激活。

 

Q3:虚拟环境文件夹应该放在哪里?

 

放在项目文件夹里,和你的代码在一起。这样每个项目都有自己的虚拟环境,清晰明了。

 

 

Q4:虚拟环境文件夹要不要提交到 Git?

 

不要! 虚拟环境文件夹很大,而且不同电脑环境不同。应该在 .gitignore 文件里把 .venv/ 加进去。别人拿到你的代码后,自己创建虚拟环境,然后用 requirements.txt 安装依赖就行。

 

 

Q5:怎么确认我当前在不在虚拟环境里?

 

看命令行提示符有没有 (.venv) 前缀,或者运行:

which python    # Mac/Linux
where python    # Windows

如果在虚拟环境里,显示的路径会包含 .venv 文件夹。

 

 

八、小结

 

虚拟环境是Python开发的必备技能,其实并不复杂:

  1. 创建:python -m venv .venv
  2. 激活:source .venv/bin/activate(Mac/Linux)或 .venv\Scripts\activate(Windows)
  3. 装包:pip install 包名
  4. 导出:pip freeze > requirements.txt
  5. 退出:deactivate

养成好习惯:每个Python项目都使用独立的虚拟环境,这样可以避免很多依赖冲突的麻烦

 


评论
User Image
提示:请评论与当前内容相关的回复,广告、推广或无关内容将被删除。

相关文章
一、什么是虚拟环境?简单来说,虚拟环境就像一个独立的“小房间” 。你在电脑上写Python程序时,可能需要用到各种第三方的库(比如requests、flask、
Python简介​Python是一种流行的编程语言,由Guido van Rossum创建,并于1991年发布
Python httplib2 简介学习使用Python httplib2模块
了解python中的变量,声明局部变量和全局变量
前言在Python(或任何其他编程语言)中,注释用于解释源代码
​Python关键字是python编程语言的保留字,这些关键字不能用于其他目的
Python –数据类型数据类型定义变量的类型
前言本教程学习在Python中使用CSV文件
1. Python整数类型值​​​​​​​​在Python中,一个int或整数是:不含小数的整数正,负或零无限长度可能包含下划线以提高可读性x = 10 y = 123456789876543...
Ollama 是一个用于运行和管理大型语言模型的工具,它支持通过环境变量来配置其行为。以下是一些常用的 Ollama 环境变量:1. OLLAMA_HOST作用
Python string.startswith()方法用于检查特定文本模式(例如URL方案等)的字符串以什么开头
Python OrderedDict,一个OrderedDict 维护插入顺序添加到字典中的项目
一.前言俗话说,工欲善其事必先利其器,本教程主要讲解如何在sublime编辑器中安装python软件包,以实现自动完成等功能,并在sublime编辑器本身中运行build
Python示例将N元素元组或序列解压缩为N个变量的集合
Python string.endswith()用于检查特定文本模式(例如域名扩展等)的字符串结尾