KnowledgeDocs

主题

UV ​

概述 ​

什么是 UV？ ​

UV 是一个轻量级的 Python 版本管理工具，支持在同一台机器上安装多个 Python 版本，并能方便地在项目间切换不同版本，避免环境冲突。

文档 ​

安装 ​

MacOS ​

bash
brew install uv

Windows ​

bash
irm https://astral.sh/uv/install.ps1 | iex

使用 ​

  1. 查看可用 Python 版本
bash
uv python list
  1. 下载指定版本
bash
uv python install 3.12
  1. 固定指定版本
bash
uv python pin 3.12
  1. 初始化项目
bash
uv init 项目名称
  1. 新增项目依赖
bash
uv add 依赖名称
  1. 卸载项目依赖
bash
uv remove 依赖名称
  1. 同步项目依赖
  1. 该命令会根据 pyproject.toml 中的依赖配置，安装项目依赖，确保项目环境与配置一致。
  2. 会移除项目中未在配置中列出的依赖。
bash
uv sync
  1. 创建虚拟环境

可在目录后指定虚拟环境目录名称，默认为 .venv。

bash
uv venv
  1. 激活虚拟环境
bash
# MacOS & Linux
source .venv/bin/activate

# Windows
.venv\Scripts\activate
  1. 退出虚拟环境
bash
deactivate
  1. 运行脚本
bash
uv run xx.py