课程六:Python虚拟环境——给项目一个“独立小房间”

适合对象：零编程基础的大一新生  课程目标：理解虚拟环境的作用，掌握创建、激活、使用和退出虚拟环境的全流程，避免项目依赖冲突。

课程大纲

模块1：为什么需要虚拟环境？——从“电脑卡顿”说起

• 生活类比
  ：
• 想象你的电脑是一个大书架，不同项目（如“网页开发”“数据分析”）需要不同的书（库/依赖）。  
• 如果所有书混在一起，找书时会混乱；虚拟环境就是给每个项目一个独立书架，互不干扰。  
• 核心问题
  ：
• 不同项目可能依赖同一库的不同版本（如项目A需要requests 2.0，项目B需要requests 3.0）。
• 全局安装库会导致版本冲突，虚拟环境通过“隔离环境”解决这一问题。  

模块2：创建你的第一个虚拟环境——手把手操作

• 步骤1：安装虚拟环境工具（内置，无需额外安装）

• Python 3.3+自带venv模块，直接使用。

• 步骤2：创建虚拟环境（带完整路径）

  # Windows（命令提示符/CMD）python -m venv D:\my_env  # 完整路径：D盘根目录下的my_env文件夹# macOS/Linux（终端）python3 -m venv ~/Documents/my_env  # 完整路径：用户文档目录下的my_env文件夹

• 效果：生成指定路径的虚拟环境文件夹，包含独立的Python解释器和库。

• 步骤3：激活虚拟环境（带完整路径）

  # WindowsD:\my_env\Scripts\activate.bat# macOS/Linuxsource ~/Documents/my_env/bin/activate

• 成功标志：命令行提示符前出现(my_env)前缀，如(my_env) C:\>或(my_env) ~$。

• 步骤4：验证隔离效果

  # 在虚拟环境中安装库（带清华源加速）pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple/ --quietpip install requests==2.0 -i https://pypi.tuna.tsinghua.edu.cn/simple/ --quiet# 退出环境后查看全局环境deactivate  # 退出虚拟环境pip show requests  # 显示全局环境中的requests（可能未安装或版本不同）

模块3：虚拟环境的日常使用——项目开发的“标准操作”

• 场景1：项目初始化

• 每次开始新项目时，先创建虚拟环境，再安装项目依赖。

  # 创建环境（带完整路径）python -m venv D:\project_env  # Windowspython3 -m venv ~/Documents/project_env  # macOS/Linux# 激活环境D:\project_env\Scripts\activate.bat  # Windowssource ~/Documents/project_env/bin/activate  # macOS/Linux# 安装项目依赖（带阿里云源加速）pip install flask==2.0 -i https://mirrors.aliyun.com/pypi/simple/ --quiet

• 场景2：共享项目给同学

• 用pip freeze导出依赖清单：

  pip freeze > D:\requirements.txt

• 同学拿到项目后，创建同名虚拟环境，用pip install -r D:\requirements.txt一键安装所有依赖（可指定国内镜像源加速）。

  # 在虚拟环境中安装库 - 先升级 pippip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple/ --quiet# 在虚拟环境中安装库 - 再安装项目依赖pip install -r D:\requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/ --quiet

• 场景3：多环境切换

• 不同项目使用不同虚拟环境，通过activate/deactivate快速切换，避免混乱。

• 示例流程：

  # 当前在环境A（D:\my_env）中开发网页项目(my_env) D:\> python app.py  # 运行网页服务# 需要切换到环境B（D:\data_env）处理数据分析任务(my_env) D:\> D:\my_env\Scripts\deactivate.bat  # 退出环境AD:\> D:\data_env\Scripts\activate.bat  # 激活环境B(data_env) D:\> python analyze.py  # 运行数据分析脚本

• 注意事项：

• 路径准确性：deactivate需通过完整路径调用（尤其是Windows），避免因环境变量未配置导致失败。
• 快速切换技巧：  
• 在终端中直接输入deactivate（macOS/Linux）可退出当前环境（需已配置环境变量）。
• 为常用环境创建快捷方式（如Windows的.bat脚本或macOS的别名），减少路径输入。

模块4：虚拟环境的高级技巧——从“能用”到“好用”

• 技巧1：自动激活环境

• 在项目目录下创建activate脚本（如Windows的.bat文件），双击运行自动激活。

• 技巧2：删除虚拟环境

• 直接删除环境文件夹（如D:\my_env或~/Documents/my_env），无残留文件。

• 技巧3：环境可视化工具

• 推荐使用pipenv或poetry（进阶工具），但本课聚焦基础venv，保持简单。

模块5：综合实战——搭建你的第一个项目环境

• 任务
  ：创建一个“班级管理系统”项目，使用虚拟环境并安装必要库。
• 步骤
  ：

1. 创建虚拟环境D:\class_env（Windows）或~/Documents/class_env（macOS/Linux）。

2. 激活环境后，安装pandas（处理数据）和openpyxl（读写Excel），使用清华源加速：

   pip install pandas openpyxl -i https://pypi.tuna.tsinghua.edu.cn/simple/ --quiet

3. 编写简单代码读取班级名单Excel文件，并打印学生姓名。

4. 导出依赖到requirements.txt，分享给同学验证。

课程总结与作业

1. 总结
   ：

• 虚拟环境是项目开发的“独立小房间”，避免依赖冲突。  
• 核心操作：创建(python -m venv 完整路径)→激活(路径\Scripts\activate)→使用(pip install -i 镜像源)→退出(deactivate)。
• 最佳实践：每个项目使用独立虚拟环境，配合requirements.txt共享依赖。

1. 课后作业
   ：

• 作业1：在你的电脑上创建名为D:\my_first_env（Windows）或~/Documents/my_first_env（macOS/Linux）的虚拟环境，激活后安装numpy库（使用阿里云源），退出环境后验证全局环境是否受影响。
• 作业2：编写一个requirements.txt文件，包含flask和requests库（指定版本），分享给同学并指导其使用清华源安装。

1. 参考资料
   ：

• 廖雪峰Python教程： Python虚拟环境详解 https://liaoxuefeng.com/books/python/built-in-modules/venv/index.html
• Python官方文档：Python venv https://docs.python.org/3/library/venv.html

课程特色：

• 生活化类比
  ：用“书架”“小房间”等场景解释抽象概念，降低理解门槛。
• 操作步骤拆解
  ：分步骤演示Windows/macOS/Linux的不同命令，避免学生操作迷茫。
• 安全警示
  ：强调删除环境前确认无重要数据，避免误删。
• 实战驱动
  ：通过“班级管理系统”项目，让学生亲自动手搭建环境，体验虚拟环境的实际价值。