如何创建独立虚拟环境使用方法

创建独立的 Python 虚拟环境是解决依赖冲突、保持系统清洁以及确保项目可复现性的最佳实践。Python 3.3+ 版本内置了 venv 模块,无需安装第三方工具即可轻松实现。

以下是创建、激活、使用及管理独立虚拟环境的完整指南:

  1. 创建虚拟环境

首先,打开终端(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 大版本,必须删除旧环境并重新创建。

  1. 激活虚拟环境

创建完成后,需要“激活”该环境,使当前的命令行会话指向虚拟环境中的 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
  1. 在虚拟环境中管理依赖

激活环境后,所有的 pip 操作都仅针对当前虚拟环境,不会影响系统全局或其他项目。

  • 安装包:
    pip install requests pandas numpy
    
  • 查看已安装的包:
    pip list
    
  • 导出依赖列表(用于共享或重建环境):
    pip freeze > requirements.txt
    
  • 从文件恢复依赖(在新机器或新环境中):
    pip install -r requirements.txt
    
  1. 退出虚拟环境

当完成开发工作或需要切换回系统全局环境时,只需运行:

deactivate

终端提示符前的 (myenv) 标识消失,表示已退出虚拟环境。

  1. 删除虚拟环境

虚拟环境本质上只是一个包含 Python 解释器副本和库文件的文件夹。因此,删除虚拟环境非常简单:直接删除该文件夹即可。

  1. 确保先执行 deactivate 退出环境。

  2. 删除文件夹:

    • Windows: rmdir /s /q myenv 或在资源管理器中手动删除。
    • macOS/Linux: rm -rf myenv
  3. 最佳实践与常见问题

  • 不要将虚拟环境提交到 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生成,内容仅供参考

posted @ 2026-09-29 04:42  nxhujiee  阅读(9)  评论(0)    收藏  举报