Python 包与环境管理工具 uv 常用命令

查看 Python 版本

uv python list

输出

PS C:\Users\test> uv python list
cpython-3.15.0a8-windows-x86_64-none                 <download available>
cpython-3.15.0a8+freethreaded-windows-x86_64-none    <download available>
cpython-3.14.4-windows-x86_64-none                   <download available>
cpython-3.14.4+freethreaded-windows-x86_64-none      <download available>
cpython-3.13.13-windows-x86_64-none                  <download available>
cpython-3.13.13+freethreaded-windows-x86_64-none     <download available>
cpython-3.12.13-windows-x86_64-none                  <download available>
cpython-3.12.10-windows-x86_64-none                  C:\Py312\python.exe
cpython-3.11.15-windows-x86_64-none                  <download available>
cpython-3.10.20-windows-x86_64-none                  <download available>
cpython-3.9.25-windows-x86_64-none                   <download available>
cpython-3.8.20-windows-x86_64-none                   <download available>
pypy-3.11.15-windows-x86_64-none                     <download available>
pypy-3.10.16-windows-x86_64-none                     <download available>
pypy-3.9.19-windows-x86_64-none                      <download available>
pypy-3.8.16-windows-x86_64-none                      <download available>
graalpy-3.12.0-windows-x86_64-none                   <download available>
graalpy-3.11.0-windows-x86_64-none                   <download available>
graalpy-3.10.0-windows-x86_64-none                   <download available>

初始化项目

uv init my-uv-project

自动生成项目文件夹，文件夹中包含一下文件。.venv会在uv run后生成。

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----         4/13/2026  11:04 AM            109 .gitignore
-a----         4/13/2026  11:04 AM              5 .python-version
-a----         4/13/2026  11:04 AM             83 main.py
-a----         4/13/2026  11:04 AM            151 pyproject.toml
-a----         4/13/2026  11:04 AM              0 README.md

运行项目

uv run main.py

输出

PS C:\code\python\my-uv> uv run main.py
Using CPython 3.12.10 interpreter at: C:\Py312\python.exe
Creating virtual environment at: .venv
Hello from my-uv!

依赖管理

添加依赖

以添加网络请求库requests为例。

uv add requests

输出

PS C:\code\python\my-uv> uv add requests
Resolved 6 packages in 1.26s
Prepared 5 packages in 775ms
Installed 5 packages in 484ms
 + certifi==2026.2.25
 + charset-normalizer==3.4.7
 + idna==3.11
 + requests==2.33.1
 + urllib3==2.6.3

移除依赖

uv remove requests

同步依赖

当从Git上来取代码时，本地没有.venv，需要执行uv sync安装依赖。

把项目环境同步到uv.lock所锁定的版本集合，确保装的依赖是同一套。

uv sync

创建 venv 虚拟环境

可以手动创建.venv，但一般用于已有老项目requirement.txt。

初始化 venv

选择目录，并使用如下命令

uv venv

输出

Using CPython 3.12.10 interpreter at: C:\Py312\python.exe
Creating virtual environment at: .venv
Activate with: .venv\Scripts\activate
PS C:\code\python\uv-demo> .venv\Scripts\activate

激活 venv

.venv\Scripts\activate

官方文档

https://docs.astral.sh/uv

GitHub

https://github.com/astral-sh/uv