Python管理UV-命令&实例汇总(一)

xiangyong582026-04-22 8:59

UV管理Python Project

✅ 创建&激活虚拟环境

首先创建一个项目：

bash 复制代码

uv init my-project
#touch requirements.txt  创建空 requirements.txt
cd my-project

项目主要结构：

bash 复制代码

my-project/
├── .venv/            # uv 创建的虚拟环境
├── .gitignore        # 可选
├── pyproject.toml    # 项目依赖（推荐用）
├── main.py           # 可选
├── requirements.txt  # 可选
└── src/              # 可选代码目录
# 也可以管理多个项目，此时项目结构有所改变

默认会在当前目录创建 .venv，并写入 .venv 文件：

bash 复制代码

uv venv         # 在当前目录创建 .venv
#uv venv path/to/env  # 自定义路径

激活：

bash 复制代码

source .venv/bin/activate   # macOS / Linux
.venv\Scripts\activate      # Windows

之后建其他python项目文件，再运行run：

bash 复制代码

uv run python your_main.py

✅命令简介

命令	描述
run	运行命令或脚本
init	创建一个新项目
add	向项目中添加依赖项
remove	从项目中移除依赖项
sync	更新项目的环境
lock	更新项目的锁定文件
export	将项目的锁定文件导出为其他格式
tree	显示项目的依赖树
tool	运行和安装由 Python 包提供的命令
python	管理 Python 版本和安装
pip	使用兼容 pip 的接口管理 Python 包
venv	创建虚拟环境
build	将 Python 包构建为源代码分发包和 wheels
publish	将分发包上传到索引
cache	管理 uv 的缓存
self	管理 uv 可执行文件
version	显示 uv 的版本
generate-shell-completion	生成 shell 自动补全脚本
help	显示某个命令的文档

uv 使用实例

...

Reference

$1$ . CLI 参考