不同项目可能依赖不同版本的库,虚拟环境把每个项目隔离开。
# 每个项目有自己的 node_modules/
cd my-project
npm install express # 装到当前项目
npx create-react-app . # 项目隔离
# 全局安装
npm install -g typescript
# 每个项目有自己的 .venv/
cd my-project
python3 -m venv .venv
source .venv/bin/activate
uv add requests # 装到当前环境
# 退出虚拟环境
deactivate
# 创建虚拟环境
python3 -m venv .venv
# 激活(Linux/Mac)
source .venv/bin/activate
# 激活(Windows)
# .venv\Scripts\activate
# 激活后终端前面会显示 (.venv)
(.venv) $ python3 --version
# 安装包
pip install requests
# 退出
deactivate
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
| pip | uv | 作用 |
|---|---|---|
pip install xxx | uv add xxx | 安装包 |
pip uninstall xxx | uv remove xxx | 卸载包 |
pip freeze | uv pip compile | 导出依赖 |
python script.py | uv run script.py | 运行脚本 |
现代 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",
]
uv init todo-cli
cd todo-cli
uv add pydantic
uv add --dev pytest
# uv init 自动创建 pyproject.toml 和 README.md
# 传统方式
pip freeze > requirements.txt
# uv 方式
uv pip compile pyproject.toml -o requirements.txt
# requirements.txt 是传统格式,很多老项目还在用
uv add --dev ruff pytest
# 运行 lint
uv run ruff check .
# 运行测试
uv run pytest
# ruff = ESLint + Prettier 的 Python 版
# pytest = Vitest 的 Python 版