UV管理Python Project

✅ 创建&激活虚拟环境

首先创建一个项目:

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

项目主要结构:

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

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

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

激活:

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

之后建其他python项目文件,再运行run:

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 参考

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐