uv = 新一代超高速 Python 包管理 + 构建 + CLI 工具(Rust 实现) 替代:pip、virtualenv、pipx、poetry install、pip install -e、pip-run 等。
安装 uv #
curl:
curl -LsSf https://astral.sh/uv/install.sh | shHomebrew (macOS):
brew install uv确认版本:
uv --version包管理 #
包安装 / 卸载 / 更新 #
添加并安装包:
uv add <package>卸载并移除包:
uv remove <package>同步安装环境依赖:
uv sync安装本地项目(开发模式):
uv pip install -e .项目依赖管理 #
安装 pyproject.toml 中所有依赖:
uv pip install .安装锁定依赖:
uv pip sync生成锁文件:
uv lockNote
修改依赖后记得: uv pip install .
查看已安装包 #
列出已安装包:
uv pip list查看项目依赖树:
uv pip tree运行 Python 程序 #
运行脚本:
uv run script.py带依赖临时执行:
uv run --with requests script.py运行模块:
uv run -m <module>管理 CLI 工具(替代 pipx) #
安装 CLI 工具:
uv tool install <package>安装当前项目:
uv tool install .之后可全局使用:
polymarket-agents --help列出已安装工具:
uv tool list升级工具:
uv tool upgrade <tool>卸载工具:
uv tool remove <tool>使用 uvx(临时运行 CLI:类似 npx) #
一次性运行:
uvx <package> <args>例如:
uvx ruff check .Tip
无需安装!
运行 HTTP 请求:
uvx httpx https://example.com运行 python-repl:
uvx ipython虚拟环境管理 #
创建 venv:
uv venv指定 Python 版本:
uv venv --python 3.11激活 venv (bash/zsh):
source .venv/bin/activatefish:
source .venv/bin/activate.fish移除 venv:
rm -rf .venv项目初始化与构建 #
快速项目初始化(Poetry 风格) #
uv init会创建:
pyproject.toml.venv- 基本结构
项目构建 #
构建 wheel + sdist:
uv build输出存放在 dist/。
发布包 #
uv publish支持:
- PyPI
- 自建 index
清理缓存 #
清理缓存:
uv cache clean查看缓存占用:
uv cache list全局设置 Python 版本 #
示例:使用 3.11
uv python install 3.11查看已安装版本:
uv python list推荐工作流 #
初始化新项目 #
Tip
从零开始一个新项目:
# 初始化项目
uv init
# 添加依赖
uv add <package>
# 以可编辑模式安装项目本身
uv pip install -e .