【python创建虚拟环境】彻底掌握：是什么、为什么、在哪里、多少、如何、怎么

在Python开发的世界里，拥抱虚拟环境是一项至关重要的实践，它能帮助开发者避免常见的依赖冲突、保持项目独立性，并极大地提升开发效率与环境的整洁度。本文将围绕Python虚拟环境的核心疑问，从“是什么”到“如何操作”，提供一份详尽、具体的指南。

一、是什么？虚拟环境的核心概念

Python虚拟环境（Virtual Environment），顾名思义，是一个独立的、隔离的Python运行环境。你可以将其想象成一个“沙盒”或者“独立的容器”，在这个容器内部，拥有自己专属的Python解释器副本和一套独立的第三方包集合。

1.1 核心特点

环境隔离： 虚拟环境最核心的价值在于其隔离性。它使得每个项目可以拥有自己所需的特定版本的库，而不会与系统全局的Python环境或其他项目的Python环境发生冲突。
独立的Python解释器： 创建虚拟环境时，它通常会复制或链接到系统上的一个Python解释器副本。在这个虚拟环境被激活后，所有对python或pip命令的调用都将指向这个独立的解释器和它内部的工具。
独立的包管理： 在虚拟环境中安装的任何包都只会存在于这个虚拟环境中，不会污染系统全局的Python安装，也不会影响其他虚拟环境。

简单来说，虚拟环境就是为你的Python项目量身定制的、一个拥有专属“家当”（解释器和库）的独立空间。

二、为什么？使用虚拟环境的必要性与优势

既然系统已经安装了Python，为什么还需要虚拟环境呢？这正是虚拟环境存在的最大价值所在。

2.1 解决依赖冲突

这是使用虚拟环境最主要的原因。考虑以下场景：

项目A需要使用requests库的1.0版本。
项目B需要使用requests库的2.0版本。

如果没有虚拟环境，直接在全局环境中安装这两个版本会导致冲突，因为同一时间只能有一个版本的requests库存在。而有了虚拟环境：

为项目A创建一个虚拟环境，安装requests==1.0。
为项目B创建另一个虚拟环境，安装requests==2.0。

两个项目都可以在各自的环境中正常运行，互不干扰。

2.2 保持系统全局环境的清洁

随着你开发的项目越来越多，如果所有第三方库都直接安装在全局Python环境中，很快就会变得臃肿、混乱，甚至可能出现一些难以预料的问题。虚拟环境确保你只为当前项目安装必要的库，用完即弃，保持全局环境的纯净。

2.3 提高项目可复现性

当项目需要部署到服务器或与他人协作时，虚拟环境可以让你精确地记录项目所依赖的所有库及其版本（通过requirements.txt文件）。这样，在其他机器上，只需要简单地安装这些依赖，就能确保项目运行环境的一致性，从而实现高度的可复现性。

2.4 便于项目管理与删除

当你完成一个项目后，如果这个项目有自己的虚拟环境，你只需要简单地删除该虚拟环境所在的文件夹，所有与该项目相关的Python库和配置都会一并被清理掉，不会在你的系统中留下任何残留，非常方便。

三、在哪里？虚拟环境的推荐存放位置

虚拟环境可以存放在系统上的任何位置，但为了管理方便和符合行业惯例，强烈建议将其存放在你项目的根目录下。

3.1 推荐结构


my_python_project/
├── venv/             # 虚拟环境目录 (推荐命名)
├── src/
│   └── main.py
├── requirements.txt
├── .gitignore
└── ...

3.2 常见命名约定

venv： 这是最常见和推荐的命名，简洁明了。
.venv： 在某些IDE（如VS Code）中，使用.venv作为隐藏文件夹，可以避免在文件浏览器中显示，同时IDE也能自动识别。
env： 另一种常见的简短命名。

3.3 为什么推荐在项目目录内？

便捷性： 当你在项目目录中工作时，激活虚拟环境或执行Python脚本都更加直接。
关联性： 明确地将虚拟环境与特定项目绑定，一目了然。
版本控制忽略： 虚拟环境通常包含大量文件，不应该被提交到版本控制系统（如Git）中。将其放在项目根目录可以方便地添加到.gitignore文件中，避免不必要的上传。

四、多少？关于虚拟环境的数量与资源占用

4.1 虚拟环境的数量

一个项目，一个虚拟环境——这是最标准的实践。通常情况下，你不会为同一个项目创建多个虚拟环境，除非有特殊需求，例如测试项目在不同Python版本下的兼容性（但这通常通过pyenv、conda或Docker等工具更好地解决）。

对于每个新的Python项目，都应该创建一个全新的、独立的虚拟环境。这意味着，如果你有10个Python项目，那么你就应该有10个独立的虚拟环境。

4.2 资源占用

虚拟环境的磁盘空间占用相对较小，通常在几十MB到几百MB之间，具体取决于其中安装的第三方库的数量和大小。

初始创建： 刚创建时，虚拟环境会复制或链接一个Python解释器副本和pip等基本工具，这大约会占用几十MB的空间。
安装库后： 每当你通过pip install命令安装一个库，这些库的文件就会被下载并存放到虚拟环境的site-packages目录下，从而增加其占用的空间。大型库（如TensorFlow、PyTorch）可能会显著增加虚拟环境的大小。

由于现代硬盘空间普遍较大，这种占用通常不会成为问题。而且，虚拟环境是完全隔离的，如果你删除一个项目，其对应的虚拟环境也会被一起删除，不会产生碎片化。

五、如何？基于venv模块创建与管理虚拟环境的详细步骤

Python 3.3及更高版本内置了venv模块，这是官方推荐的创建虚拟环境的方式。它轻量、高效且无需额外安装。对于Python 2.x或需要更高级功能的场景，可以使用第三方工具virtualenv，但本文主要聚焦于venv。

5.1 创建虚拟环境

5.1.1 进入项目目录

首先，打开你的终端或命令行工具，导航到你希望创建虚拟环境的项目根目录。如果项目目录尚不存在，可以先创建它：


mkdir my_python_project
cd my_python_project

5.1.2 执行创建命令

使用以下命令创建名为venv的虚拟环境（推荐名称）：

python3 -m venv venv
或者，如果你系统中只有Python 3：
python -m venv venv

python3 (或 python)： 指的是你系统上已安装的Python 3解释器。确保你使用的是你希望虚拟环境基于的Python版本。
-m venv： 告诉Python执行venv模块。
venv (第二个venv)： 这是你给虚拟环境目录起的名字。你可以替换成任何你喜欢的名称，例如env或.venv。

执行此命令后，会在当前目录下创建一个名为venv的新文件夹。这个文件夹包含了独立的Python解释器、pip工具以及其他必要的支持文件。

5.1.3 常用创建参数（可选）

--without-pip： 创建一个没有安装pip的虚拟环境。这在非常特定的场景下可能有用，但通常不推荐，因为pip是安装Python包的核心工具。
--system-site-packages： 允许虚拟环境访问系统全局的site-packages目录中的包。这意味着你在全局环境中安装的包在虚拟环境中也可见。虽然这可以节省一些空间，但通常会破坏虚拟环境的隔离性，所以不推荐在生产环境或需要严格隔离的项目中使用。

5.2 激活虚拟环境

创建好虚拟环境后，在使用它之前必须先“激活”它。激活虚拟环境会在你当前的shell会话中修改PATH环境变量，确保当你运行python或pip命令时，调用的是虚拟环境内部的解释器和工具。

5.2.1 激活命令（根据操作系统选择）

Linux 或 macOS：


        source venv/bin/activate

Windows (CMD 命令行)：


        venv\Scripts\activate.bat

Windows (PowerShell)：

        venv\Scripts\Activate.ps1
        
如果遇到“无法加载文件”的错误，可能是PowerShell的执行策略问题。你可以临时允许执行本地脚本：
        Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
        
然后重试激活命令。使用完毕后，可以考虑恢复执行策略：
        Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Restricted
        

5.2.2 激活成功的标志

成功激活后，你的命令行提示符通常会显示虚拟环境的名称（例如(venv)）作为前缀，表明你当前正处于虚拟环境中。


(venv) user@host:~/my_python_project$

此时，你可以运行which python（Linux/macOS）或where python（Windows）来验证Python解释器的路径是否指向虚拟环境内部。

5.3 在虚拟环境中安装Python包

激活虚拟环境后，使用标准的pip install命令安装任何你需要的第三方包。这些包只会安装到当前的虚拟环境中。


(venv) pip install requests beautifulsoup4 Flask

你也可以检查当前虚拟环境中安装了哪些包：


(venv) pip list

5.4 冻结与导出项目依赖

为了项目的可复现性，你应该记录下项目中所有依赖的库及其精确版本。这通过pip freeze命令实现，并将结果输出到一个名为requirements.txt的文件中。


(venv) pip freeze > requirements.txt

当你或其他人需要在另一个环境中部署或运行此项目时，只需激活虚拟环境，然后使用以下命令安装所有依赖：


(venv) pip install -r requirements.txt

5.5 退出/停用虚拟环境

当你完成项目工作，或者需要切换到另一个项目时，可以通过deactivate命令退出当前的虚拟环境。


(venv) deactivate

退出后，你的命令行提示符会恢复到正常状态，并且python和pip命令将再次指向系统全局的Python解释器和包。

5.6 删除虚拟环境

删除虚拟环境非常简单，只需删除其对应的文件夹即可。这不会影响你的系统全局Python或其他虚拟环境。

确保已退出虚拟环境： 在删除之前，请务必先deactivate当前虚拟环境。

删除命令：

Linux 或 macOS：


                rm -rf venv

Windows (CMD 命令行)：


                rd /s /q venv

Windows (PowerShell)：


                Remove-Item -Recurse -Force venv

六、怎么？高效使用与常见问题处理

6.1 与IDE的集成

现代的Python集成开发环境（IDE）如PyCharm、VS Code、Jupyter等都对虚拟环境提供了出色的支持，它们能自动识别和使用项目目录下的虚拟环境，甚至在创建项目时提供创建虚拟环境的选项。

PyCharm： 在创建新项目时，PyCharm会默认提示你创建一个新的虚拟环境。在项目设置中，你可以轻松地选择或添加现有的虚拟环境。它会自动激活并使用该环境中的解释器和库。
VS Code： 安装Python扩展后，VS Code能够自动检测工作区中的虚拟环境。你可以通过命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）搜索“Python: Select Interpreter”，然后选择你项目中的虚拟环境。VS Code会在终端中自动激活它。

利用IDE的这些功能，可以极大地简化虚拟环境的日常管理。

6.2 版本控制忽略文件（.gitignore）

在你的Git项目中，务必将虚拟环境目录添加到.gitignore文件中，以避免将其提交到版本库。虚拟环境是本地构建的，不应随代码一起共享。

在项目根目录的.gitignore文件中添加以下内容：


# Python virtual environment
venv/
.venv/
env/

# Python cache files
__pycache__/
*.pyc

# IDE specific files
.idea/      # For PyCharm
.vscode/    # For VS Code (optional, depends on shared settings)

6.3 常见问题及解决方案

问题：命令行提示符没有显示(venv)前缀，或者pip list显示的是全局安装的包。
- 原因： 虚拟环境没有被激活。
- 解决方案： 确保你执行了正确的激活命令（根据你的操作系统）。
问题：在虚拟环境中安装包时提示“权限不足”。
- 原因： 激活命令可能没有完全生效，或者你正在尝试在没有正确权限的目录下创建或修改文件。
- 解决方案： 再次确认虚拟环境已激活。避免使用sudo pip install，因为这会将包安装到系统全局环境，破坏隔离性。如果是在受限环境下，请联系管理员。
问题：我创建了虚拟环境，但项目使用的Python版本不是我想要的。
- 原因： 在创建虚拟环境时，你执行的python3 -m venv venv命令中的python3指向了系统上你不想用的Python版本。
- 解决方案： 确保你的python3命令指向的是你希望的Python解释器。例如，如果你安装了pyenv，可以使用pyenv global 3.9.10来切换全局Python版本，然后再创建虚拟环境。或者直接指定完整路径，如/usr/bin/python3.9 -m venv venv。
问题：requirements.txt中有些包安装失败或版本不兼容。
- 原因： 可能是requirements.txt中的依赖与当前Python版本不兼容，或者存在深层依赖冲突。
- 解决方案： 仔细检查requirements.txt中失败的包。尝试使用pip check命令来查找环境中的依赖冲突。如果问题复杂，可能需要手动调整requirements.txt中的包版本，或者考虑使用更强大的依赖管理工具如Poetry或Pipenv。

记住：虚拟环境的核心在于其“隔离性”和“独立性”。任何破坏这两点的行为（如--system-site-packages、sudo pip install）都应谨慎对待或避免。

通过掌握上述内容，你将能够熟练地创建、管理和使用Python虚拟环境，从而构建更健壮、可维护且易于协作的Python项目。