使用Python虚拟环境可隔离项目依赖，避免版本冲突。推荐使用venv模块创建独立环境：在项目目录运行python3 -m venv .venv，激活后（Linux/macOS: source .venv/bin/activate；Windows: .venv\Scripts\activate）安装所需包，退出时执行deactivate。为确保Python版本一致，可指定版本创建环境，如python3.8 -m venv .venv。依赖通过pip freeze > requirements.txt导出，新环境用pip install -r requirements.txt安装。.venv目录不应提交至版本控制，应加入.gitignore，以防仓库膨胀和跨平台问题。
Python虚拟环境是项目依赖管理的利器，它能隔离不同项目的依赖，避免版本冲突。简单来说，它就像一个独立的“小房间”，每个项目都可以在自己的“房间”里安装所需的依赖包，互不干扰。
创建和管理Python虚拟环境，核心在于
venv模块（Python 3.3+）和
virtualenv工具（适用于更早的Python版本）。
解决方案：
-
使用
venv
(推荐):立即学习“Python免费学习笔记（深入）”；
创建虚拟环境: 在你的项目目录下，打开终端，运行
python3 -m venv .venv
（.venv
是虚拟环境的目录名，你可以自定义）。 这会在项目目录下创建一个名为.venv
的文件夹，包含 Python 解释器、pip 和其他必要的文件。-
激活虚拟环境:
-
Linux/macOS:
source .venv/bin/activate
-
Windows:
.venv\Scripts\activate
激活后，你的终端提示符会发生变化，通常会显示虚拟环境的名称，例如
(.venv)
。 -
Linux/macOS:
安装依赖: 激活虚拟环境后，使用
pip install
安装项目所需的依赖包。 这些包会被安装到虚拟环境的lib/pythonX.X/site-packages
目录下，与系统环境隔离。退出虚拟环境: 在终端输入
deactivate
。
-
使用
virtualenv
(如果你的Python版本低于3.3):-
安装
virtualenv
:pip install virtualenv
-
创建虚拟环境:
virtualenv .venv
-
激活和退出虚拟环境: 与
venv
相同。
-
安装
创建虚拟环境时，指定Python版本有什么用？
指定Python版本创建虚拟环境，确保项目使用的Python解释器版本与你的需求一致。例如，你的项目需要Python 3.8，而系统默认是Python 3.9，那么创建虚拟环境时可以指定 Python 3.8。
-
venv
:python3.8 -m venv .venv
(需要你的系统已经安装了 Python 3.8) -
virtualenv
:virtualenv -p /usr/bin/python3.8 .venv
(需要指定Python 3.8解释器的路径)
这样做的好处是，避免了因Python版本不兼容导致的项目运行问题。
如何管理虚拟环境的依赖？
管理虚拟环境的依赖，主要通过
requirements.txt文件实现。
导出依赖: 在激活的虚拟环境中，运行
pip freeze > requirements.txt
。 这会将当前虚拟环境中所有已安装的包及其版本号，写入requirements.txt
文件。安装依赖: 在新的环境或克隆的项目中，激活虚拟环境后，运行
pip install -r requirements.txt
。 这会根据requirements.txt
文件中的记录，安装所有依赖包及其对应的版本。
requirements.txt相当于项目的“依赖清单”，方便项目在不同环境下的部署和复现。 我个人习惯在每次修改项目依赖后，都更新一下
requirements.txt，以保持依赖的同步。
虚拟环境目录
.venv应该提交到版本控制系统吗？
通常情况下，
.venv目录不应该提交到版本控制系统（例如 Git）。 原因如下：
- 体积大: 虚拟环境包含大量的依赖包，会导致仓库体积膨胀。
- 平台依赖: 不同操作系统和 Python 版本的虚拟环境可能存在差异，提交到版本控制系统可能会导致其他开发者在不同平台上遇到问题。
-
可再生性: 虚拟环境可以通过
requirements.txt
文件轻松重建。
因此，建议将
.venv目录添加到
.gitignore文件中，忽略对它的跟踪。 其他开发者可以通过
requirements.txt文件，在自己的环境中重建虚拟环境。 我曾经因为忘记忽略
.venv目录，导致 Git 仓库体积暴增，后来不得不清理历史提交，非常麻烦。 所以，一定要记得忽略！
