Python如何创建虚拟环境？venv模块使用技巧-Python教程-PHP中文网

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

看不見的法師

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

原创

658人浏览过

创建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 <package_name> 安装包，所有依赖将隔离存储于虚拟环境内。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 <package_name>
```
登录后复制
安装项目所需的依赖包。例如，
```
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有什么区别？我应该用哪个？

阿里云-虚拟数字人

阿里云-虚拟数字人是什么？ ...

查看详情

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版本一致。
激活脚本损坏: 如果以上方法都无效，可能是激活脚本损坏。可以尝试删除虚拟环境目录，然后重新创建虚拟环境。