如何创建独立虚拟环境使用方法
创建独立的 Python 虚拟环境是解决依赖冲突、保持系统清洁以及确保项目可复现性的最佳实践。Python 3.3+ 版本内置了 venv 模块,无需安装第三方工具即可轻松实现。
以下是创建、激活、使用及管理独立虚拟环境的完整指南:
- 创建虚拟环境
首先,打开终端(macOS/Linux)或命令提示符/PowerShell(Windows),进入你的项目根目录。
基本命令:
python -m venv myenv
myenv是虚拟环境的名称,你可以将其替换为任何你喜欢的名字(如.venv,venv,project_env等)。通常建议使用.venv,因为在许多编辑器中以.开头的文件夹默认会被隐藏,保持目录整洁。
指定 Python版本(多版本共存时):
如果你系统中安装了多个 Python 版本(例如同时有 3.12 和 3.14),需要明确指定使用哪个解释器来创建环境:
- Windows:
py -3.14 -m venv myenv - macOS/Linux:
python3.14 -m venv myenv
注意:虚拟环境一旦创建,其绑定的 Python 版本就固定了。如果需要切换 Python 大版本,必须删除旧环境并重新创建。
- 激活虚拟环境
创建完成后,需要“激活”该环境,使当前的命令行会话指向虚拟环境中的 Python 解释器和 pip。激活后,终端提示符前通常会显示环境名称(如 (myenv))。
| 操作系统 | Shell/终端类型 | 激活命令 |
|---|---|---|
| Windows | Command Prompt (cmd) | myenv\Scripts\activate.bat |
| Windows | PowerShell | myenv\Scripts\Activate.ps1 (若报错需先执行: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser) |
| macOS / Linux | Bash / Zsh | source myenv/bin/activate |
验证是否激活成功:
运行以下命令,确认路径指向虚拟环境内部:
which python macOS/Linux
where python Windows
python --version
- 在虚拟环境中管理依赖
激活环境后,所有的 pip 操作都仅针对当前虚拟环境,不会影响系统全局或其他项目。
- 安装包:
pip install requests pandas numpy - 查看已安装的包:
pip list - 导出依赖列表(用于共享或重建环境):
pip freeze > requirements.txt - 从文件恢复依赖(在新机器或新环境中):
pip install -r requirements.txt
- 退出虚拟环境
当完成开发工作或需要切换回系统全局环境时,只需运行:
deactivate
终端提示符前的 (myenv) 标识消失,表示已退出虚拟环境。
- 删除虚拟环境
虚拟环境本质上只是一个包含 Python 解释器副本和库文件的文件夹。因此,删除虚拟环境非常简单:直接删除该文件夹即可。
-
确保先执行
deactivate退出环境。 -
删除文件夹:
- Windows:
rmdir /s /q myenv或在资源管理器中手动删除。 - macOS/Linux:
rm -rf myenv
- Windows:
-
最佳实践与常见问题
- 不要将虚拟环境提交到 Git:
请在.gitignore文件中添加虚拟环境的目录名(如myenv/或.venv/),避免将庞大的二进制文件上传到代码仓库。只提交requirements.txt或pyproject.toml。 - IDE 配置:
在 VS Code、PyCharm 等编辑器中打开项目时,IDE 通常会自动检测并询问是否使用发现的虚拟环境作为解释器。如果没有自动检测,请手动在 IDE 设置中选择虚拟环境目录下的python可执行文件。 - 避免权限问题:
永远不要使用sudo pip install在虚拟环境中安装包。如果遇到权限错误,请检查是否已正确激活虚拟环境,或者检查项目目录的读写权限。 - Conda 用户注意:
如果你使用 Anaconda 或 Miniconda,可以使用conda create -n myenv python=3.14创建环境,并使用conda activate myenv激活。Conda 环境不仅管理 Python 包,还能管理非 Python 的二进制依赖(如 CUDA、C++ 库),适合数据科学场景。但对于纯 Python 开发,内置的venv更轻量且标准。
通过以上步骤,你可以为每个项目建立干净、隔离的开发环境,有效避免“依赖地狱”问题。
参考资料
[1] Python虚拟环境详解:创建、使用与最佳实践-CSDN博客 - CSDN博客
[2] Python 在系统 Windows 和 Ubuntu 中创建虚拟环境_ubantu系统跑代码创建虚拟环境-CSDN博客 - CSDN博客
[3] Python官网虚拟环境的使用技巧_Python官网环境隔离详细指南-Python教程-PHP中文网 - php中文网
[4] 如何使用Python创建虚拟环境_多版本环境管理详解【指导】-Python教程-PHP中文网 - php中文网
[5] 如何创建Python虚拟环境_创建Python虚拟环境的多种方法与对比-Python教程-PHP中文网 - PHP中文网
[6] Python 虚拟环境完全指南:venv、virtualenv 与 Conda详解_python_脚本之家 - 脚本之家
[7] Python3.11镜像新手教程:手把手教你创建第一个独立Python环境-CSDN博客 - CSDN博客
[8] Python虚拟环境(venv)的全面使用指南_python_脚本之家 - 脚本之家
[9] Python官方venv虚拟环境的完整实操教程_python_脚本之家 - 脚本之家
[10] Python虚拟环境详解:创建、使用与最佳实践-CSDN博客 - CSDN博客
[11] virtualenv,一个超级厉害的 Python 库!-腾讯云开发者社区-腾讯云 - 腾讯云
[12] Python虚拟环境创建与管理全攻略_文心快码 - 文心快码
[13] Python虚拟环境实战:隔离依赖与高效开发指南-CSDN博客 - CSDN博客
[14] 别再乱装Python包了!手把手教你用Windows自带的venv创建独立开发环境(附代理和换源配置)-CSDN博客 - CSDN博客
[15] Python多版本环境管理与虚拟环境创建指南-Python教程-PHP中文网 - php中文网
[16] Python 虚拟环境创建(venv) | 菜鸟教程 - m.runoob.com
[17] Python多版本管理与虚拟环境创建指南-Python教程-PHP中文网 - php中文网
[18] Python 虚拟环境创建(venv) | 菜鸟教程 - www.runoob.com
[19] Python 虚拟环境创建全指南:保持项目环境干净有序_python 创建虚拟环境-CSDN博客 - CSDN博客
[20] Python命令如何创建虚拟环境 Python命令虚拟环境创建的实用指南-Python教程-PHP中文网 - php中文网
[21] Python虚拟环境管理的全指南_python_脚本之家 - 脚本之家
[22] Python多版本管理与特定版本虚拟环境创建教程-Python教程-PHP中文网 - php中文网
[23] 保姆级教程:Python虚拟环境的创建、进入与退出(附uv/pip双版本)_python创建虚拟环境-CSDN博客 - CSDN博客
[24] python的几种虚拟环境创建方式_python创建虚拟环境-CSDN博客 - CSDN博客
[25] Python多版本环境下的虚拟环境创建与管理指南-Python教程-PHP中文网 - php中文网
[26] 【python】创建python虚拟环境 - 知乎 - 知乎
[27] python中虚拟环境创建的主流方式详细操作指南_python_脚本之家 - 脚本之家
百度AI生成,内容仅供参考

浙公网安备 33010602011771号