Python如何创建虚拟环境？venv模块使用技巧

看不見的法師

发布时间：2025-08-08 10:50:02

704人浏览过

来源于php中文网

原创

创建python虚拟环境是为了隔离项目依赖、避免版本冲突，推荐使用python自带的venv模块。1. 创建虚拟环境：在项目目录下运行 python3 -m venv .venv，生成包含独立python和pip的 .venv 文件夹。2. 激活虚拟环境：linux/macos运行 source .venv/bin/activate，windows运行 .venv\scripts\activate，激活后终端提示符会显示环境名称。3. 安装依赖包：使用 pip install 安装包，所有依赖将隔离存储于虚拟环境内。4. 导出依赖列表：通过 pip freeze > requirements.txt 生成依赖文件。5. 安装依赖列表：使用 pip install -r requirements.txt 一键还原环境。6. 退出虚拟环境：执行 deactivate 命令即可退出。虚拟环境目录通常选在项目根目录下命名为 .venv（推荐，隐藏且易被git忽略），也可集中存放于 envs 目录或临时存于 /tmp。venv 是python 3.3+内置工具，无需安装，适合大多数场景；virtualenv 是第三方工具，功能更强但需额外安装，复杂项目可考虑 conda。若激活失败，应检查：1. 虚拟环境是否已正确创建；2. 激活命令路径和系统平台是否匹配；3. 脚本是否有执行权限，必要时使用 chmod +x 赋权；4. 环境变量如 pythonpath 是否干扰；5. 使用的终端是否支持激活脚本；6. python版本是否一致；7. 激活脚本是否损坏，若损坏则删除并重建环境。问题通常可通过上述步骤解决。

Python如何创建虚拟环境？venv模块使用技巧

创建Python虚拟环境，本质上是为了隔离不同项目所需的依赖包，避免版本冲突。venv模块是Python自带的工具，简单易用，推荐使用。

解决方案：

创建虚拟环境: 在你的项目目录下，打开终端，运行
```
python3 -m venv .venv
```
（
```
.venv
```
是虚拟环境的目录名，可以自定义）。这会在当前目录下创建一个名为
```
.venv
```
的文件夹，里面包含了Python解释器、pip等工具的副本。

立即学习“Python免费学习笔记（深入）”；
激活虚拟环境: 激活虚拟环境才能使后续的pip操作作用于该环境。
- 在Linux或macOS上，运行
```
source .venv/bin/activate
```
- 在Windows上，运行
```
.venv\Scripts\activate
```
激活后，你的终端提示符会显示虚拟环境的名称，例如
```
(.venv) $
```
。
安装依赖包: 激活虚拟环境后，使用
```
pip install 
```
安装项目所需的依赖包。例如，
```
pip install requests
```
。所有安装的包都会被保存在虚拟环境的
```
lib
```
目录下，与全局Python环境隔离。
导出依赖包列表: 为了方便其他人或在其他机器上重建虚拟环境，可以使用
```
pip freeze > requirements.txt
```
将当前环境的依赖包及其版本导出到
```
requirements.txt
```
文件中。
从依赖包列表安装: 当拿到
```
requirements.txt
```
文件后，可以使用
```
pip install -r requirements.txt
```
一次性安装所有依赖包。
退出虚拟环境: 使用
```
deactivate
```
命令退出虚拟环境。

如何选择虚拟环境目录？

虚拟环境目录的选择其实挺灵活的，但通常我会选择以下几种方案：

项目根目录下的
.venv
: 这是最常见的做法，将虚拟环境放在项目根目录下，并以
```
.venv
```
命名。点开头的文件或目录在Linux/macOS上默认是隐藏的，可以避免污染项目目录。 Git也会默认忽略
```
.venv
```
目录，避免将虚拟环境提交到代码仓库。
单独的
envs
目录: 如果你的项目结构比较复杂，或者有多个项目共享某些依赖包，可以创建一个单独的
```
envs
```
目录，将所有虚拟环境都放在这里。例如，
```
envs/project1_env
```
，
```
envs/project2_env
```
。
临时目录: 对于一些临时性的脚本或测试，可以将虚拟环境放在临时目录下，例如
```
/tmp/my_env
```
。但要注意，临时目录可能会被系统清理，所以不要存放重要的数据。

venv和virtualenv有什么区别？我应该用哪个？

Replit Ghostwrite

一种基于 ML 的工具，可提供代码完成、生成、转换和编辑器内搜索功能。

下载

venv是Python 3.3及以上版本自带的虚拟环境管理工具，而virtualenv是一个独立的第三方库。它们的功能类似，但venv无需额外安装，使用起来更方便。

venv: Python自带，无需安装，使用简单。但功能相对简单，例如没有自动切换虚拟环境的功能。
virtualenv: 需要额外安装，功能更强大，例如可以自动切换虚拟环境、管理多个Python版本等。

通常情况下，venv已经足够满足大部分项目的需求。如果需要更高级的功能，可以考虑使用virtualenv或其他更专业的虚拟环境管理工具，例如conda、pipenv等。个人经验是，对于简单的项目，venv足够了，而对于复杂的项目，conda可能更适合，因为它也能管理非Python的依赖。

虚拟环境激活失败怎么办？常见错误及解决方法

虚拟环境激活失败是常见问题，原因有很多，但通常可以按以下步骤排查：

确认虚拟环境已创建: 首先确认虚拟环境目录存在，并且里面包含了
```
bin
```
(Linux/macOS) 或
```
Scripts
```
(Windows) 目录。
检查激活命令是否正确: 激活命令的路径是否正确？是否使用了正确的激活命令（
```
source .venv/bin/activate
```
或
```
.venv\Scripts\activate
```
）？注意区分Linux/macOS和Windows的激活命令。
权限问题: 在Linux/macOS上，如果激活脚本没有执行权限，可以使用
```
chmod +x .venv/bin/activate
```
赋予执行权限。
环境变量问题: 某些情况下，环境变量可能会干扰虚拟环境的激活。可以尝试临时清空一些环境变量，例如
```
PYTHONPATH
```
，然后重新激活虚拟环境。
终端问题: 某些终端可能不支持虚拟环境的激活。可以尝试使用其他终端，例如bash、zsh、PowerShell等。
Python版本问题: 如果虚拟环境的Python版本与系统Python版本不一致，可能会导致激活失败。确保虚拟环境的Python版本与系统Python版本一致。
激活脚本损坏: 如果以上方法都无效，可能是激活脚本损坏。可以尝试删除虚拟环境目录，然后重新创建虚拟环境。

如果遇到更复杂的问题，可以查看激活脚本的输出，或者搜索相关的错误信息，通常可以找到解决方案。

使用正则表达式中的反向引用精确匹配重复内容

Python多线程和多进程的区别_Python线程与进程核心差异对比

Python 面向对象是否一定要建模？

Python 如何写出可测试的代码？

Python 设计哲学如何影响工程实践？

相关专题

python开发工具

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

772

2023.06.15

python打包成可执行文件

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

661

2023.07.20

python能做什么

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

764

2023.07.25

format在python中的用法

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

679

2023.07.31

python教程

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

1365

2023.08.03

python环境变量的配置

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

569

2023.08.04

python eval

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

579

2023.08.04

scratch和python区别

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

730

2023.08.11