在 Ubuntu 中创建 Python 虚拟环境的完整指南

2025-06-02

在 Ubuntu 系统中,为了保持项目依赖的独立性,我们常常使用 Python 的虚拟环境(venv)。本文将从安装依赖、创建虚拟环境、处理可能出现的问题以及使用国内 pip 源等方面,逐步讲解虚拟环境的创建过程。


🧱 一、安装 venv 所需组件

Ubuntu 默认并不一定安装 venv 模块。使用以下命令安装:

sudo apt update sudo apt install python3.10-venv

如果你使用的是其他版本的 Python,例如 3.11,请相应替换命令中的版本号,例如:

sudo apt install python3.11-venv

⚠️ 二、常见错误及解决

错误提示:

The virtual environment was not created successfully because ensurepip is not available.

这说明系统未安装 python3.X-venv 模块。安装后即可解决。


🚀 三、创建虚拟环境

切换到你的项目目录:

cd /your/project/path

然后创建虚拟环境(以 .venv 命名):

python3.10 -m venv .venv

或指定你需要的版本:

python3.11 -m venv .venv

✅ 四、激活虚拟环境

source .venv/bin/activate

激活后,终端前会出现 (.venv) 前缀,说明已成功进入虚拟环境。

✅ 五、退出虚拟环境

deactivate

📌 总结

步骤

命令

安装 venv 模块

sudo apt install python3.X-venv

创建虚拟环境

python3.X -m venv .venv

激活虚拟环境

source .venv/bin/activate

安装依赖

pip install -r requirements.txt

永久设置 pip 源

修改 ~/.pip/pip.conf

退出虚拟环境

deactivate

NEXT
Linux 修改文件权限方法总结