name: python-env description: “使用uv进行快速的Python环境管理（比pip快10-100倍）。触发词：uv, venv, pip, pyproject, python环境, 安装包, 依赖项。” compatibility: “需要uv CLI工具。安装命令：curl -LsSf https://astral.sh/uv/install.sh | sh” allowed-tools: “Bash” depends-on: [] related-skills: []

Python环境管理

使用uv进行快速的Python环境管理。

快速命令

任务	命令
创建虚拟环境	`uv venv`
安装包	`uv pip install requests`
从requirements安装	`uv pip install -r requirements.txt`
运行脚本	`uv run python script.py`
显示已安装包	`uv pip list`

虚拟环境

# 创建虚拟环境（瞬时完成）
uv venv

# 使用特定Python版本创建
uv venv --python 3.11

# 激活（或使用uv run）
source .venv/bin/activate  # Unix
.venv\Scripts\activate     # Windows

包安装

# 单个包
uv pip install requests

# 多个包
uv pip install flask sqlalchemy pytest

# 带额外功能
uv pip install "fastapi[all]"

# 版本约束
uv pip install "django>=4.0,<5.0"

# 卸载
uv pip uninstall requests

最小化pyproject.toml

[project]
name = "my-project"
version = "0.1.0"
requires-python = ">=3.10"
dependencies = [
    "httpx>=0.25",
    "pydantic>=2.0",
]

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

项目设置清单

mkdir my-project && cd my-project
uv venv
# 创建pyproject.toml
uv pip install -e ".[dev]"
uv pip list

故障排除

问题	解决方案
“未找到Python”	`uv python install 3.11`
Python版本错误	`uv venv --python 3.11`
依赖冲突	`uv pip compile --resolver=backtracking`
缓存问题	`uv cache clean`

使用场景

始终使用uv替代pip以获得速度优势
创建虚拟环境
安装软件包
管理依赖项
在项目上下文中运行脚本

额外资源

如需详细模式，请加载：

./references/pyproject-patterns.md - 完整的pyproject.toml示例、工具配置
./references/dependency-management.md - 锁文件、工作区、私有包
./references/publishing.md - PyPI发布、版本控制、CI/CD

另请参阅

这是一个基础技能，无需先决条件。

基于此技能的构建：

python-typing-patterns - 项目类型提示
python-pytest-patterns - 测试基础设施
python-fastapi-patterns - Web API开发