UV 是一个现代 Python 开发的高效工具，旨在简化和加速 Python 项目的开发流程。它提供了一个集成的环境，支持快速构建、测试和部署 Python 应用程序。

安装

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

常见命令

  1. 创建新项目

    # 初始化时会自动建立 pyproject.toml、uv.lock 和 .python-version 等文件，记得检查
uv init new_project

  2. 控制Python版本

    修改 .python-version 文件中的版本号即可更改默认 Python 版本

  3. 添加包依赖

    # 第一次运行会自动创建.venv的虚拟环境（不要这个环境直接删除文件夹即可）
# add 会自动管理 pyproject.toml 和 uv.lock，不管临时还是永久的包都推荐用这种方式安装而不是用 uv pip install
uv add fastapi uvicorn

  4. 删除包依赖

    uv remove fastapi uvicorn

  5. 运行项目

    # uv run 会自动带入虚拟环境
uv run uvicorn main:app --reload

  6. clone 后同步

    # uv sync 会自动安装 pyproject.toml 中的依赖并更新 .venv，确保开发环境与生产环境一致
uv sync

评价

搭配 VS Code 使用，体验比 PyCharm 丝滑多了，算是补上了环境管理的短板。

参考资料