UV 使用

UV 优势#

• 🚀 A single tool to replace pip, pip-tools, pipx, poetry, pyenv, twine, virtualenv, and more.
• ⚡️ 10-100x faster than pip.
• 🗂️ Provides comprehensive project management, with a universal lockfile.
• ❇️ Runs scripts, with support for inline dependency metadata.
• 🐍 Installs and manages Python versions.
• 🛠️ Runs and installs tools published as Python packages.
• 🔩 Includes a pip-compatible interface for a performance boost with a familiar CLI.
• 🏢 Supports Cargo-style workspaces for scalable projects.
• 💾 Disk-space efficient, with a global cache for dependency deduplication.
• ⏬ Installable without Rust or Python via curl or pip.
• 🖥️ Supports macOS, Linux, and Windows.

安装#

1
# 安装
2
brew install uv
3
# mise
4
# mise use -g uv@latest

配置镜像源#

$XDG_CONFIG_HOME/uv/uv.toml

1
[[index]]
2
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
3
default = true

迁移micromanba#

1
# 迁移 micromamba 到 uv
2
micromamba list -e > requirements.txt
3
uv pip install -r requirements.txt

使用#

Python versions#

• uv python install: Install Python versions.
• uv python list: View available Python versions.
• uv python find: Find an installed Python version.
• uv python pin: Pin the current project to use a specific Python version.
• uv python uninstall: Uninstall a Python version.

Scripts#

• uv run: Run a script.
• uv add --script: Add a dependency to a script
• uv remove --script: Remove a dependency from a script

Projects#

• uv init: Create a new Python project.
• uv add: Add a dependency to the project.
• uv remove: Remove a dependency from the project.
• uv sync: Sync the project’s dependencies with the environment.
• uv lock: Create a lockfile for the project’s dependencies.
• uv run: Run a command in the project environment.
• uv tree: View the dependency tree for the project.
• uv build: Build the project into distribution archives.
• uv publish: Publish the project to a package index.

Tools#

• uvx / uv tool run: Run a tool in a temporary environment.
• uv tool install: Install a tool user-wide.
• uv tool uninstall: Uninstall a tool.
• uv tool list: List installed tools.
• uv tool update-shell: Update the shell to include tool executables.

The pip interface#

• uv venv: Create a new virtual environment.
• uv pip install: Install packages into the current environment.
• uv pip show: Show details about an installed package.
• uv pip freeze: List installed packages and their versions.
• uv pip check: Check that the current environment has compatible packages.
• uv pip list: List installed packages.
• uv pip uninstall: Uninstall packages.
• uv pip tree: View the dependency tree for the environment.
• uv pip compile: Compile requirements into a lockfile.
• uv pip sync: Sync an environment with a lockfile.

Utility#

• uv cache clean: Remove cache entries.
• uv cache prune: Remove outdated cache entries.
• uv cache dir: Show the uv cache directory path.
• uv tool dir: Show the uv tool directory path.
• uv python dir: Show the uv installed Python versions path.
• uv self update: Update uv to the latest version.