快速认识python项目的虚拟环境

为什么需要虚拟环境?

想象一下:你有两个项目:

  • **项目A** 需要 `requests==2.25.1`

  • **项目B** 需要 `requests==2.28.0`

如果没有虚拟环境,两个项目共用同一个 Python 环境和同一份依赖,**版本就会冲突**。虚拟环境就是给每个项目分配一个**独立的"房间"**,各玩各的,互不干扰。

```

系统 Python(全局)

├── 项目A的虚拟环境 venv_A

│ └── requests 2.25.1

└── 项目B的虚拟环境 venv_B

└── requests 2.28.0

```


新手标准流程

1. 创建虚拟环境

在你项目的根目录下运行:

```bash

python3 -m venv venv

```

> `venv` 是虚拟环境文件夹的名字,你可以叫 `env`、`myenv` 等

创建完成后,你的项目目录看起来是这样的:

```

my_project/

├── venv/ ← 虚拟环境(不要提交到 Git)

├── main.py

└── requirements.txt

```

2. 激活虚拟环境

```bash

Linux / macOS

source venv/bin/activate

Windows

venv\Scripts\activate

```

激活成功后,终端会显示虚拟环境的名字:

```

(venv) afeng@ubuntu:~/my_project$

```

3. 安装依赖

激活后,`pip` 安装的包只会进到当前虚拟环境:

```bash

pip install requests flask

```

4. 冻结依赖(可选但推荐)

记录项目用了哪些包,方便别人复现:

```bash

pip freeze > requirements.txt

```

之后别人只需运行:

```bash

pip install -r requirements.txt

```

5. 退出虚拟环境

```bash

deactivate

```


每个新项目的完整操作

```bash

1. 进入项目目录

cd ~/my_project

2. 创建虚拟环境(只需创建一次)

python3 -m venv venv

3. 激活

source venv/bin/activate

4. 安装依赖

pip install flask requests

5. 运行项目

python main.py

6. 完成后退出

deactivate

```


常见坑

| 问题 | 解决 |

|------|------|

| `pip install` 没效果 | 检查是否已激活虚拟环境 `(venv)` |

| 上传代码到 Git | 把 `venv/` 加入 `.gitignore` |

| 重新开始项目 | 删除 `venv/` 文件夹,重新 `python3 -m venv venv` 即可 |


进阶替代方案

对于更复杂的项目,还可以使用:

  • **conda** --- 支持 Python 之外的语言环境

  • **pipenv** --- 把 pip 和虚拟环境合二为一

  • **poetry** --- 现代 Python 项目管理工具

但作为新手,从标准的 `venv` 开始完全够用。等你熟悉后再逐步尝试这些工具。

相关推荐
Java展博33 分钟前
[Go 后端转场] 从 try-catch 到 if err != nil:写惯 Java 的人第一次上手最别扭的 4 件事
java·开发语言·golang
SEO_juper40 分钟前
Node.js 全站 SEO 体检报告生成器:一次查完标题、描述、canonical、H1、图片
开发语言·前端·node.js·html·bash
典学长编程1 小时前
LangGraph 快速入门:从 StateGraph 到 ReAct Agent
python·有向图·无向图·langgraph·react agent·stategraph
风落青芜1 小时前
数据结构:堆的概念与实现
c语言·开发语言·数据结构·算法
用户019027581613 小时前
AlphaFeed 查不到代码返回空?非法/缺后缀 symbol 的行为与处理
python
isfox3 小时前
Python 单元测试:别再用 print 调试了,写个测试一劳永逸
python
用户298698530144 小时前
在 Python 中把 Word 文档转换为 JSON 的三种实现方式
python·json·api
用户0332126663674 小时前
使用 Python 删除 Excel 中的空白行或空白列
python·excel
databook4 小时前
时间序列特征,哪些当时就能算出来
python·数据分析
kevin_org4 小时前
LangChain入门学习(四)
python·学习·langchain·fastapi