Python venv(虚拟环境)的安装与使用指南
1. 什么是venv？
venv是Python内置的虚拟环境管理工具，用于创建独立的Python环境，避免不同项目间的依赖冲突。
2. 安装和启用
2.1. Linux(Ubuntu)
Ubuntu系统，从Ubuntu 23.04开始，默认使用的Python版本是3.11。而Python 3.11 开始支持 PEP 668 的“外部管理环境”标记。
系统级的 Python 包管理被标记为外部管理，阻止直接使用pip install安装Python包。
1. 安装Python venv:
1
2
3
4
5
6
7
8
9
10
|
sudo apt update
sudo apt install python3
sudo apt install python3-venv
python3 --version
|
2. 创建虚拟环境:
1
2
3
4
5
|
python3 -m venv myenv
python3 -m venv /path/to/your/project/venv
|
3. 激活虚拟环境:
1
2
3
4
5
|
source myenv/bin/activate
(myenv) user@host:~$
|
4. 退出虚拟环境:
2.2. Windows
1. 安装Python:
从Python官网下载并安装Python，安装时勾选Add Python to PATH。
2. 创建虚拟环境:
1
2
3
4
5
|
python -m venv myenv
py -3.9 -m venv myenv
|
3. 激活虚拟环境:
1
2
3
4
5
6
7
8
|
myenv\Scripts\activate.bat
myenv\Scripts\Activate.ps1
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
4. 退出虚拟环境:
3. 虚拟环境的使用
3.1. 创建带特定选项的虚拟环境
1
2
3
4
5
6
7
8
|
python3 -m venv --without-pip myenv
python3 -m venv --system-site-packages myenv
python3.9 -m venv myenv
|
3.2. 虚拟环境的使用
在虚拟环境下安装和使用包
1
2
3
4
5
6
7
8
9
10
11
|
pip install requests pandas
pip list
pip freeze > requirements.txt
pip install -r requirements.txt
|
3.3. 虚拟环境的管理
1
2
3
4
5
6
|
which python
which pip
pip -V
|
4. 项目中使用venv的最佳实践
4.1. 项目结构建议
1
2
3
4
5
| my_project/
├── venv/
├── src/
├── requirements.txt
└── README.md
|
4.2. .gitignore配置
1
2
3
4
5
6
7
8
| # 忽略虚拟环境
venv/
env/
*.env
# 忽略Python缓存
__pycache__/
*.pyc
|
4.3. 创建项目自动化脚本
Linux/Mac: setup.sh:
1
2
3
4
| #!/bin/bash
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
|
Windows: setup.bat:
1
2
3
4
| @echo off
python -m venv venv
venv\Scripts\activate.bat
pip install -r requirements.txt
|
