虚拟环境搭建

常用虚拟环境工具

工具名称	类型	Python版本支持	安装方式	特点	适用场景
venv（推荐）	内置模块	≥ 3.3	无需安装，内置	轻量级、官方推荐、使用简单	通用开发、日常项目
virtualenv	第三方工具	2.x 和 3.x	pip install virtualenv	功能丰富、兼容多版本	需要兼容旧版本或高级功能
conda	Anaconda自带	2.x 和 3.x	随 Anaconda/Miniconda 安装	跨语言包管理、数据科学生态	数据科学、机器学习项目

Python 3.3+ 内置了 venv 模块，无需额外安装。

1.检查 Python 版本：

python3 --version
# 或者
python --version

2.创建虚拟环境：

# 基本语法
python3 -m venv 环境名称

例如，创建一个名为 .venv 的虚拟环境：

实例

# 进入项目目录
mkdir my_project && cd my_project

# 创建虚拟环境（命名为'.venv'是常见约定）
python3 -m venv .venv

参数说明：

-m venv：使用 venv 模块
.venv：虚拟环境的名称（可以自定义）
创建后的目录结构

.venv/
├── bin/            # 在 Unix/Linux 系统上
│   ├── activate    # 激活脚本
│   ├── python      # 环境 Python 解释器
│   └── pip         # 环境的 pip
├── Scripts/        # 在 Windows 系统上
│   ├── activate    # 激活脚本
│   ├── python.exe  # 环境 Python 解释器
│   └── pip.exe     # 环境的 pip
└── Lib/            # 安装的第三方库

3.激活虚拟环境

激活环境后，所有 Python 和 pip 命令都会使用虚拟环境中的版本。

Windows 系统
.venv\Scripts\activate
Unix/Linux/MacOS 系统
source .venv/bin/activate

激活成功后，命令行提示符通常会显示环境名称：

(.venv) $

4.使用虚拟环境

安装包
在激活的环境中，使用 pip 安装的包只会影响当前环境：

pip install package_name
例如：

# 安装单个包（如Django）
(.venv) pip install django==3.2.12

# 安装多个包
(.venv) pip install requests pandas

查看已安装的包

(.venv) pip list
Package    Version
---------- -------
Django     3.2.12
pip        21.2.4

5.导出依赖

(.venv) pip freeze > requirements.txt
requirements.txt 文件内容示例：

Django==3.2.12
requests==2.26.0
pandas==1.3.3

6.从文件安装依赖

(.venv) pip install -r requirements.txt

7.退出虚拟环境

当完成工作后，可以退出虚拟环境：

deactivate

退出后，命令行提示符会恢复正常，Python 和 pip 命令将使用系统全局版本。

8.删除虚拟环境

要删除虚拟环境，只需删除对应的目录即可：

# 确保已退出环境
deactivate

# 删除目录
rm -rf .venv  # Linux/macOS
del /s /q .venv  # Windows (命令提示符)

常见问题分析

在使用Python开发时，如果在使用虚拟环境后遇到了“找不到包”的错误，通常是因为以下几个原因：

1. 未激活虚拟环境：确保你已经激活了正确的虚拟环境。
2. 安装包未成功：可能你在安装包时遇到了错误，或者根本没有在虚拟环境中安装包。
3. 包安装在全局环境中：有时候可能会不小心在全局Python环境中安装了包，而不是在虚拟环境中。
4. 路径问题：Python可能没有正确设置其环境变量，导致它找不到安装在虚拟环境中的包。

解决步骤

1. 激活虚拟环境

确保你的虚拟环境已经创建并且被激活。使用以下命令来激活虚拟环境（以venv为例）：

对于Windows
.\venv\Scripts\activate

对于macOS和Linux
source venv/bin/activate

激活后，你的命令行提示符应该会发生变化，显示当前激活的虚拟环境名称。

2. 安装包

在激活的虚拟环境中安装缺失的包。使用pip命令：

pip install package_name

例如，如果你需要安装requests，你应该在虚拟环境中运行：

pip install requests

3. 检查包是否已安装

确保包已经正确安装在你的虚拟环境中。你可以使用以下命令来列出已安装的包：

pip list

检查列表中是否包含你刚刚安装的包。

4. 确保使用正确的Python解释器

有时候，你的IDE（如PyCharm, VSCode等）可能没有使用正确的Python解释器。确保你的IDE配置为使用虚拟环境中的Python解释器。在PyCharm中，你可以在“Settings” -> “Project: your_project_name” -> “Python Interpreter”中设置。

5. 重新启动IDE或编辑器

有时候，简单地重启你的开发环境可以解决路径或环境变量的问题。

通过上述步骤，你应该能够解决在使用Python虚拟环境时遇到的“找不到包”的问题。如果问题仍然存在，请检查是否有权限问题或者虚拟环境的路径设置是否正确。