一文详解如何使用uv创建并管理一个新的空白的python项目

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 或使用 pip
pip install uv

# 创建项目目录
mkdir myproject
cd myproject

# 初始化项目（创建虚拟环境、pyproject.toml等）
uv init

uv init myproject --python 3.11  # 指定Python版本和生成项目名称`myproject`
# 如果想要将当前目录作为项目，那么请使用：
uv init --python 3.12
cd myproject

# 添加依赖
uv add requests pandas numpy

# 添加开发依赖
uv add --dev pytest black mypy

# 从requirements.txt安装
uv pip compile requirements.txt -o pyproject.toml

# 安装所有依赖
uv sync

# 运行Python脚本
uv run python script.py

# 启动虚拟环境shell
uv shell

# 运行测试
uv run pytest

# 查看依赖树
uv tree

[project]
name = "myproject"
version = "0.1.0"
description = "My awesome project"
dependencies = [
    "requests>=2.28.0",
    "pandas>=2.0.0",
]

[project.optional-dependencies]
dev = ["pytest>=7.0.0", "black>=23.0.0"]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

# 创建项目
uv init <project-name>

# 添加/移除依赖
uv add <package>
uv remove <package>

# 更新所有依赖
uv sync --upgrade

# 冻结依赖版本
uv lock

# 清理缓存
uv cache clean

# 在现有项目中初始化uv
cd existing-project
uv init --force  # 保留现有pyproject.toml

# 从现有环境迁移
uv pip freeze > requirements.txt
uv add -r requirements.txt

# Windows（PowerShell）
irm https://astral.sh/uv/install.ps1 | iex

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

cd 你的项目文件夹

# 创建虚拟环境（自动用项目 Python 版本）
uv venv
# 你可以指定本地 python 路径
uv venv --python "your python path."
# 激活
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate

uv sync

uv run main.py
uv run fastapi dev main.py