Day 13 · 虚拟环境与包管理

Week 2 · Day 13 / 56 · 返回大纲

一、为什么需要虚拟环境

不同项目可能依赖不同版本的库,虚拟环境把每个项目隔离开。

JavaScript
# 每个项目有自己的 node_modules/
cd my-project
npm install express  # 装到当前项目
npx create-react-app .  # 项目隔离

# 全局安装
npm install -g typescript
Python
# 每个项目有自己的 .venv/
cd my-project
python3 -m venv .venv
source .venv/bin/activate
uv add requests  # 装到当前环境

# 退出虚拟环境
deactivate

二、venv 基础

# 创建虚拟环境
python3 -m venv .venv

# 激活(Linux/Mac)
source .venv/bin/activate

# 激活(Windows)
# .venv\Scripts\activate

# 激活后终端前面会显示 (.venv)
(.venv) $ python3 --version

# 安装包
pip install requests

# 退出
deactivate

三、uv(推荐)

uv 是 Rust 写的包管理器,比 pip 快 10-100 倍,是当前 Python 生态的新标准。

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 初始化项目
uv init myproject
cd myproject

# 添加依赖
uv add requests fastapi

# 运行
uv run python main.py

# 同步环境
uv sync
pipuv作用
pip install xxxuv add xxx安装包
pip uninstall xxxuv remove xxx卸载包
pip freezeuv pip compile导出依赖
python script.pyuv run script.py运行脚本

四、pyproject.toml

现代 Python 项目用 pyproject.toml 管理依赖(类似 package.json)。

[project]
name = "todo-cli"
version = "0.1.0"
description = "Todo 命令行管理器"
requires-python = ">=3.12"
dependencies = [
    "requests>=2.31",
    "fastapi>=0.100",
]

[project.optional-dependencies]
dev = [
    "pytest>=7.0",
    "ruff>=0.1",
]

动手练习

练习 1:创建项目
用 uv 创建一个新项目
uv init todo-cli
cd todo-cli
uv add pydantic
uv add --dev pytest
查看答案
参考答案
# uv init 自动创建 pyproject.toml 和 README.md
练习 2:导出依赖
把依赖导出为 requirements.txt
# 传统方式
pip freeze > requirements.txt

# uv 方式
uv pip compile pyproject.toml -o requirements.txt
查看答案
参考答案
# requirements.txt 是传统格式,很多老项目还在用
练习 3:安装开发工具
安装 ruff 和 pytest
uv add --dev ruff pytest

# 运行 lint
uv run ruff check .

# 运行测试
uv run pytest
查看答案
参考答案
# ruff = ESLint + Prettier 的 Python 版
# pytest = Vitest 的 Python 版

打卡验收

理解虚拟环境的作用:项目隔离
会创建和激活 venv
会用 uv 初始化项目和添加依赖
理解 pyproject.toml 的结构
知道 pip 和 uv 的对应关系
完成 3 个动手练习
能独立创建一个新的 Python 项目
知道怎么导出和安装依赖
打卡方式: 全部勾选后,告诉我 "Day 13 打卡",并贴出你的代码。