Python 开发中，虚拟环境管理帮助隔离项目依赖，避免不同项目之间的依赖冲突。

虚拟环境的作用

• 隔离依赖：不同项目可能需要不同版本的库，虚拟环境可以为每个项目创建独立的环境。
• 避免全局污染：全局安装的库可能会影响其他项目，虚拟环境可以避免这种情况。
• 便于部署：虚拟环境可以轻松打包项目依赖，便于在其他环境中复现。

常用的虚拟环境管理工具

Python 提供了多种虚拟环境管理工具，以下是几种常见的选择：

(1) venv（Python 内置工具）

venv 是 Python 3.3+ 内置的虚拟环境工具，适合简单的项目。

创建虚拟环境：

python -m venv myenv

在当前目录下创建一个名为 myenv 的虚拟环境。

激活虚拟环境：

• Windows：

myenv\Scripts\activate

• Mac/Linux：

source myenv/bin/activate

退出虚拟环境：

deactivate

删除虚拟环境：直接删除虚拟环境所在的文件夹即可。

(2) virtualenv

virtualenv 是一个更灵活的虚拟环境管理工具，支持 Python 2 和 Python 3。

安装：

pip install virtualenv

创建虚拟环境：

virtualenv myenv

激活和退出：与 venv 的激活和退出方式相同。

(3) pipenv

pipenv 是一个高级工具，结合了 virtualenv 和 pip 的功能，同时支持依赖管理和锁文件。

安装：

pip install pipenv

创建虚拟环境并安装依赖：

pipenv install requests

自动创建虚拟环境并安装指定的库。

激活虚拟环境：

pipenv shell

查看依赖：

pipenv graph

(4) poetry

poetry 是一个现代化的 Python 包管理工具，支持虚拟环境、依赖管理和项目构建。

安装：参考官方文档

创建项目并初始化虚拟环境：

poetry new myproject
cd myproject
poetry install

添加依赖：

poetry add requests

激活虚拟环境：

poetry shell

uv是一个现代化的 Python 包和项目管理工具，它提供了一套完整的项目管理解决方案，包括项目初始化、虚拟环境管理、依赖管理、代码运行、测试、构建和分发等功能。

(5)uv

安装

# macOS 和 Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

或者使用pip安装：

pip install uv

创建虚拟环境

uv venv .venv --python 3.13

添加依赖

uv add requests flask

激活虚拟环境

当使用默认虚拟环境名称时，uv 将会自动在后续调用中查找并使用该虚拟环境。

source .venv/bin/activate

查看依赖

uv pip list

或

uv tree # 查看依赖树

虚拟环境的常见操作

无论使用哪种工具，以下是一些常见的虚拟环境操作：

(1) 安装依赖

在虚拟环境中安装依赖：

pip install requests numpy

(2) 导出依赖

将当前环境的依赖导出到 requirements.txt：

pip freeze > requirements.txt

(3) 导入依赖

在新的虚拟环境中安装依赖：

pip install -r requirements.txt

(4) 查看已安装的包

pip list

注意事项

路径问题：确保虚拟环境的路径不会被随意移动，否则可能会导致依赖失效。

依赖冲突：尽量使用虚拟环境隔离项目，避免全局安装的包污染环境。

版本管理：定期检查和更新依赖版本，避免安全漏洞。

常见问题

(1) 虚拟环境无法激活

• 确保虚拟环境路径正确。

• 检查是否使用了正确的激活命令（Windows 和 Mac/Linux 不同）。

(2) 依赖安装失败

• 确保虚拟环境已激活。

• 检查网络连接，可能需要配置国内镜像（如阿里云镜像）：

pip install -i https://mirrors.aliyun.com/pypi/simple/ requests

(3) 虚拟环境与 IDE 集成

• 在 PyCharm 或 VSCode 中，可以通过设置项目的解释器来选择虚拟环境。

如果你觉得这篇文章有用，欢迎点赞、转发、收藏、留言、推荐！