Python 包管理与虚拟环境最佳实践-Python教程-PHP中文网

Python 包管理与虚拟环境最佳实践

心靈之曲

发布： 2025-10-04 14:24:30

原创

1088人浏览过

python 包管理与虚拟环境最佳实践

本文旨在帮助开发者理解和掌握 Python 包管理的最佳实践，重点介绍虚拟环境的使用。通过本文，你将了解为什么不应该全局安装 Python 包，以及如何使用 venv 创建和管理独立的 Python 环境，避免依赖冲突，保证项目稳定运行。同时，本文也简要提及了在 root 用户下运行虚拟环境中的 Python 程序的方法。

为什么需要虚拟环境？

直接使用系统级的 Python 环境进行开发存在潜在的风险。操作系统可能依赖特定版本的 Python 包，全局安装第三方包可能会破坏这些依赖，导致系统不稳定。此外，不同项目可能需要不同版本的依赖包，全局安装会造成版本冲突，使得项目难以维护。

虚拟环境通过为每个项目创建独立的 Python 运行环境，隔离项目间的依赖关系，从而解决这些问题。

使用 venv 创建和管理虚拟环境

venv 是 Python 3 内置的虚拟环境管理工具，无需额外安装。以下是使用 venv 的基本步骤：

立即学习“Python免费学习笔记（深入）”；

创建虚拟环境：

在项目根目录下，执行以下命令创建虚拟环境：
```
python3 -m venv .venv
```
登录后复制
这将在项目目录下创建一个名为 .venv 的文件夹，其中包含独立的 Python 解释器和 pip 包管理器。推荐将.venv添加到.gitignore文件中，防止提交到git仓库中。
激活虚拟环境：

在开始使用虚拟环境之前，需要先激活它。激活命令根据操作系统有所不同：
- Linux/macOS:
```
source .venv/bin/activate
```
  登录后复制
- Windows:
```
.venv\Scripts\activate
```
  登录后复制
激活后，命令行提示符会显示虚拟环境的名称，例如 (.venv) $。
安装和管理包：

讯飞智作-讯飞配音
讯飞智作是一款集AI配音、虚拟人视频生成、PPT生成视频、虚拟人定制等多功能的AI音视频生产平台。已广泛应用于媒体、教育、短视频等领域。

67

查看详情

激活虚拟环境后，使用 pip 安装项目所需的包：
```
pip install <package_name>
```
登录后复制
所有安装的包都会存储在虚拟环境的 lib 目录下，不会影响系统级的 Python 环境。

可以使用 pip list 查看已安装的包，使用 pip uninstall <package_name> 卸载包。
停用虚拟环境：

完成开发后，可以使用 deactivate 命令停用虚拟环境：
```
deactivate
```
登录后复制
命令行提示符会恢复到原来的状态。

虚拟环境的最佳实践

项目根目录创建： 通常在项目根目录下创建虚拟环境，方便管理和维护。
版本控制： 将虚拟环境目录（如 .venv）添加到版本控制系统的忽略列表，避免提交到代码仓库。
依赖管理： 使用 pip freeze > requirements.txt 命令将项目依赖导出到 requirements.txt 文件，方便他人安装和复现环境。使用 pip install -r requirements.txt 命令安装所有依赖包。
选择合适的工具： 除了 venv，还有其他虚拟环境管理工具，如 virtualenv、pipenv、poetry 等。选择适合自己项目需求的工具。

在 root 用户下使用虚拟环境

通常情况下，不建议以 root 用户运行 Python 程序。如果确实需要在 root 用户下运行虚拟环境中的 Python 程序，可以采取以下方法：

指定完整路径：

直接指定虚拟环境中 Python 解释器的完整路径：
```
/home/<user>/<project>/.venv/bin/python <script.py>
```
登录后复制
激活虚拟环境：

先激活虚拟环境，再运行 Python 程序：
```
source /home/<user>/<project>/.venv/bin/activate
python <script.py>
deactivate
```
登录后复制
需要注意的是，即使在 root 用户下激活了虚拟环境，也应该避免在虚拟环境中执行需要 root 权限的操作，以防止潜在的安全风险。