Python虚拟环境完全指南：pyenv vs venv 在macOS上的使用详解

上天_去_做颗惺星 EVE_BLUE

已于 2025-08-06 23:15:32 修改

阅读量356

点赞数 4

CC 4.0 BY-SA版权

文章标签： python 开发语言虚拟环境 mac

于 2025-08-06 23:13:50 首次发布

本文链接：https://blog.csdn.net/weixin_45927422/article/details/149983611

在Python开发中，虚拟环境是管理项目依赖的重要工具。本文将详细比较pyenv创建的虚拟环境和venv创建的虚拟环境的区别，并手把手教你如何在macOS上使用venv创建、管理虚拟环境。

一、pyenv虚拟环境 vs venv虚拟环境

1. 核心区别

特性	pyenv-virtualenv	python3 -m venv
管理范围	全局管理多个Python版本和虚拟环境	单个项目级别的虚拟环境
Python版本控制	可以轻松切换不同Python版本	使用系统或指定的Python版本
隔离程度	完全隔离Python解释器和包	仅隔离Python包
创建命令	`pyenv virtualenv 3.9.1 myenv`	`python3 -m venv myenv`
激活方式	`pyenv activate myenv`	`source myenv/bin/activate`
适用场景	需要多版本Python开发	单一Python版本的项目开发

2. 优缺点分析

pyenv-virtualenv优点：

可以管理多个Python版本
环境切换更方便
适合需要测试不同Python版本的项目

pyenv-virtualenv缺点：

配置稍复杂
需要额外安装pyenv和pyenv-virtualenv插件

venv优点：

Python 3.3+内置，无需额外安装
简单易用
项目目录结构清晰

venv缺点：

不能管理不同Python版本
每个项目需要单独创建环境

二、macOS上使用venv的完整指南

1. 检查Python版本

首先确认你的macOS已安装Python 3：

python3 --version
# 或指定路径查看
/usr/bin/python3 --version

2. 创建虚拟环境

# 进入项目目录
cd ~/my_project

# 创建虚拟环境（推荐使用python3 -m venv）
python3 -m venv venv

# 或者指定Python解释器路径（如果有多个版本）
/usr/local/bin/python3 -m venv venv

3. 激活虚拟环境

# 激活虚拟环境
source venv/bin/activate

# 激活后提示符会显示环境名称
(venv) user@host my_project %

4. 验证虚拟环境

# 查看Python路径（应指向虚拟环境中的Python）
which python
which pip

# 查看Python版本
python --version

5. 安装和管理包

# 安装包（如Flask）
pip install flask

# 安装特定版本
pip install flask==2.0.1

# 从requirements.txt安装
pip install -r requirements.txt

# 列出已安装包
pip list

# 生成requirements.txt
pip freeze > requirements.txt

6. 退出虚拟环境

deactivate

7. 删除虚拟环境

只需删除虚拟环境目录即可：

rm -rf venv/

三、高级使用技巧

1. 创建带系统site-packages的虚拟环境

python3 -m venv --system-site-packages venv

2. 升级虚拟环境中的pip

source venv/bin/activate
pip install --upgrade pip

3. 使用虚拟环境运行脚本

# 直接使用虚拟环境中的Python
venv/bin/python myscript.py

# 或先激活环境再运行
source venv/bin/activate
python myscript.py
deactivate

4. 在VSCode中使用虚拟环境

打开命令面板 (Cmd+Shift+P)
搜索"Python: Select Interpreter"
选择虚拟环境中的Python解释器（路径类似./venv/bin/python）

四、常见问题解决

1. 报错：command not found: python3

# 安装Python 3（使用Homebrew）
brew install python

# 或从官网下载安装

2. 报错：Error: [Errno 13] Permission denied

# 添加--user参数
pip install --user package_name

# 或使用sudo（不推荐）
sudo pip install package_name

3. 虚拟环境激活后命令不可用

检查虚拟环境是否创建成功：

ls venv/bin  # 应看到python, pip等可执行文件

4. 不同项目共享虚拟环境

不推荐共享，最佳实践是每个项目有自己的虚拟环境。

五、最佳实践建议

每个项目单独环境：避免依赖冲突
记录依赖：总是维护requirements.txt
不提交环境到Git：在.gitignore中添加venv/
使用一致的Python版本：团队开发时约定相同版本
定期更新依赖：pip list --outdated查看可更新包

对于需要多版本Python管理的复杂场景，可以考虑结合使用pyenv+virtualenv，但对于大多数项目，venv已经足够且更简单易用。