uv 常用命令
目录
安装与检查
curl -LsSf https://astral.sh/uv/install.sh | sh
curl -LsSf https://astral.sh/uv/install.sh | sh
在 macOS 或 Linux 上下载并运行官方安装脚本。
uv --version
uv --version
查看当前安装的 uv 版本。
uv --help
uv --help
查看 uv 支持的命令和选项。
uv self update
uv self update
将通过官方独立安装器安装的 uv 更新到最新版本。
项目初始化与运行
uv init rpcats
uv init rpcats
创建并初始化名为 rpcats 的 Python 项目。
uv init
uv init
在当前目录中初始化 Python 项目。
uv run main.py
uv run main.py
在项目环境中运行 main.py。
uv run main.py Persian
uv run main.py Persian
运行 main.py 并将 Persian 作为命令行参数传入。
依赖管理
uv add requests
uv add requests
将 requests 添加为项目依赖并安装到项目环境。
uv add -r requirements.txt
uv add -r requirements.txt
将 requirements.txt 中的包导入为项目依赖。
uv add --upgrade requests
uv add --upgrade requests
升级 requests 并更新项目的锁文件。
uv remove <package_name>
uv remove <package_name>
从项目中删除指定依赖并更新依赖配置和锁文件。
uv add --dev pytest
uv add --dev pytest
将 pytest 添加为开发依赖。
环境、锁定与同步
uv venv
uv venv
在当前目录创建 .venv 虚拟环境。
uv pip list
uv pip list
列出当前项目环境中已安装的包及其版本。
uv lock
uv lock
解析项目依赖并更新 uv.lock 锁文件。
uv sync
uv sync
根据项目配置和锁文件同步项目环境。
构建发行包
uv build
uv build
同时构建源码发行包和 wheel 发行包。
uv build --sdist
uv build --sdist
仅构建源码发行包。
uv build --wheel
uv build --wheel
仅构建 wheel 发行包。