创建python虚拟环境
在 Python 中,可以使用 venv
模块(Python 3.3+ 内置)或 virtualenv
(第三方工具)来创建虚拟环境。以下是详细步骤:
方法 1:使用 venv
(推荐,Python 原生支持)
- 打开终端(Windows:CMD/PowerShell;Mac/Linux:Terminal)。
- 切换到项目目录:
cd 你的工程文件:例如:/path/to/your/project
- 创建虚拟环境:
python -m venv 虚拟环境名称:例如:venv_name
venv_name
是虚拟环境的文件夹名(通常用venv
或.venv
)。
- 激活虚拟环境:
- Windows:
#需要进入虚拟环境对应目录下,这个目录及文件都是统一的,只需要修改venv_name文件名称即可 .\venv_name\Scripts\activate
- Mac/Linux:
source venv_name/bin/activate
- 激活后,终端提示符会显示虚拟环境名称(如
(venv_name)
)。
- Windows:
- 退出虚拟环境:
#同激活虚拟环境一样,需要进入.\venv_name\Scripts\ deactivate
方法 2:使用 virtualenv
(需安装)
- 安装
virtualenv
(如果未安装):pip install virtualenv
- 创建虚拟环境:
virtualenv venv_name
- 激活/退出:与方法 1 的步骤 4-5 相同。
验证虚拟环境
- 激活后,运行
pip list
查看已安装的包,确认只有基础包(如pip
、setuptools
)。 - 使用
which python
(Mac/Linux)或where python
(Windows)检查 Python 解释器路径是否指向虚拟环境目录。
注意事项
- 忽略虚拟环境文件夹:
将venv_name/
添加到.gitignore
中,避免将虚拟环境提交到版本控制。 - 跨平台问题:
虚拟环境通常不跨平台共用,建议在不同系统上分别创建。 - 依赖管理:
激活后,用pip install -r requirements.txt
安装项目依赖。
示例流程(完整)
# 创建项目目录
mkdir my_project
cd my_project
# 创建虚拟环境
python -m venv .venv
# 激活(Windows)
.\.venv\Scripts\activate
# 安装依赖包
pip install requests pandas
# 生成 requirements.txt
pip freeze > requirements.txt
# 退出
deactivate
通过虚拟环境,你可以隔离不同项目的依赖,避免全局 Python 环境的冲突。
进阶python环境管理(pyevn)
以下是使用 pyenv 管理多版本 Python 的详细步骤:
1. 安装 pyenv
Linux/macOS
-
依赖安装:
- Ubuntu/Debian:
sudo apt-get install -y make build-essential libssl-dev zlib1g-dev \ libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \ libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
- macOS(使用 Homebrew):
brew install openssl readline sqlite3 xz zlib tcl-tk
- Ubuntu/Debian:
-
安装 pyenv:
curl https://pyenv.run | bash
-
配置环境变量:
- 在
~/.bashrc
或~/.zshrc
末尾添加:export PYENV_ROOT="$HOME/.pyenv" export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init --path)" eval "$(pyenv virtualenv-init -)" # 可选(需安装 pyenv-virtualenv)
- 应用配置:
source ~/.bashrc # 或 source ~/.zshrc
- 在
Windows(需 WSL)
在 WSL 中参照 Linux 步骤操作。
2. 安装 Python 版本
-
查看可用版本:
pyenv install --list
-
安装指定版本(如 Python 3.9.0):
pyenv install 3.9.0
3. 管理 Python 版本
全局版本
- 设置全局默认 Python 版本:
pyenv global 3.9.0
- 验证:
python --version
局部版本
在项目目录中设置特定版本:
cd /path/to/project
pyenv local 3.8.0 # 创建 .python-version 文件
查看已安装版本
pyenv versions
4. 使用 pyenv-virtualenv(虚拟环境)
-
安装插件(如果未自动安装):
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
-
创建虚拟环境:
pyenv virtualenv 3.9.0 myenv # 基于 Python 3.9.0 创建名为 myenv 的虚拟环境
-
激活/停用虚拟环境:
pyenv activate myenv # 激活 pyenv deactivate # 退出
-
删除虚拟环境:
pyenv uninstall myenv
5. 常用命令速查
命令 | 说明 |
---|---|
pyenv install --list | 查看可安装的 Python 版本 |
pyenv install 3.10.0 | 安装 Python 3.10.0 |
pyenv global 3.10.0 | 设置全局 Python 版本 |
pyenv local 3.8.0 | 设置当前目录的 Python 版本 |
pyenv versions | 列出已安装版本 |
pyenv which python | 查看当前 Python 路径 |
常见问题
安装 Python 失败
- 使用国内镜像源加速下载(如清华源、阿里云)。
通过 pyenv,你可以轻松隔离不同项目的 Python 环境,避免版本冲突问题。