Python 虚拟环境可以创建一个独立的环境,用于安装项目所需的特定 Python 包和依赖项,而不会影响系统范围内的 Python 安装。这对于管理项目的依赖关系和避免版本冲突非常有用。
下面是创建和使用 Python 3 虚拟环境的步骤:
步骤 1:安装必需的包
在创建虚拟环境之前,确保已安装必要的工具。
对于 Debian/Ubuntu 系统:
打开终端并运行以下命令:
sudo apt-get update
sudo apt-get install python3-venv python3-pip
python3-venv:提供用于创建虚拟环境的 venv 模块。
python3-pip:Python 的包管理工具,用于安装和管理 Python 包。
对于 Red Hat/CentOS/Fedora 系统:
sudo yum install python3-venv python3-pip
步骤 2:创建项目目录(可选)
为了更好地组织项目,建议为您的项目创建一个单独的目录。
mkdir my_project
cd my_project
请将 my_project 替换为您的项目名称。
步骤 3:创建虚拟环境
使用 python3 -m venv 命令创建虚拟环境,并指定虚拟环境的名称(如 venv 或 env)。
python3 -m venv venv
这将在当前目录下创建一个名为 venv 的文件夹,包含了独立的 Python 解释器和相关的包管理工具。
步骤 4:激活虚拟环境
在使用虚拟环境之前,需要先激活它。
对于 Bash、Zsh 或其他基于 Bourne Shell 的终端:
source venv/bin/activate
激活后,您会在终端提示符前看到虚拟环境的名称,类似于:
(venv) user@host:~/my_project$
步骤 5:在虚拟环境中使用 Python
现在,可以在虚拟环境中安装 Python 包,而这些包只会影响虚拟环境,不会影响系统全局的 Python 安装。
安装 Python 包
例如,安装 requests 库:
pip install requests
查看已安装的包
pip list
步骤 6:退出虚拟环境
完成工作后,可以通过以下命令退出虚拟环境:
deactivate
退出后,终端提示符将恢复到常规状态。
步骤 7:再次激活虚拟环境
在下次需要使用虚拟环境时,进入项目目录并激活环境:
cd my_project
source venv/bin/activate
步骤 8:额外提示
创建 requirements.txt 文件
为了记录和共享项目的依赖项,您可以生成一个 requirements.txt 文件:
pip freeze > requirements.txt
以后,可以通过以下命令安装文件中列出的所有包:
pip install -r requirements.txt
命名虚拟环境文件夹
您可以根据喜好命名虚拟环境文件夹,例如:
使用 .venv
(加一个点),使其在某些文件管理器中默认隐藏:
python3 -m venv .venv
source .venv/bin/activate
使用系统全局包(不推荐)
如果需要在虚拟环境中访问系统全局安装的包,可以在创建虚拟环境时使用 --system-site-packages 选项:
python3 -m venv venv --system-site-packages
但这可能会导致包版本冲突,通常不建议这样做。
总结
通过以上步骤,您可以在 Linux 上成功创建和使用 Python 3 的虚拟环境:
- 安装必要的工具:python3-venv 和 python3-pip。
- 创建虚拟环境:使用 python3 -m venv venv。
- 激活虚拟环境:source venv/bin/activate。
- 在虚拟环境中安装包:使用 pip 安装所需的 Python 包。
- 退出虚拟环境:使用 deactivate。
使用虚拟环境可以确保项目的依赖关系互不干扰,提高项目的可管理性和可移植性。