window安装uvx

安装

打开 cmd
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
这个命令会从官方源下载安装脚本并自动执行,将 uv.exe 和 uvx.exe 安装到默认目录(通常是 C:\Users<你的用户名>.uv),并自动将路径添加到系统的 PATH 环境变量中。‌

检查
uvx --version
如果看到版本号输出(如 uvx 0.8.15),则说明安装成功。‌‌

uvx介绍

uvx 是一个现代、快速的 Python 工具运行器,主要用于无需预先安装的情况下,直接运行 PyPI 上的命令行工具(如代码检查、格式化、测试等工具),同时具备出色的性能和环境隔离能力。

它类似于 npx(Node.js 生态)或 pipx(Python 生态),但基于 Rust 实现,速度更快、依赖解析效率更高,能显著提升开发体验,尤其适合临时使用工具或 CI/CD 流程中避免环境污染。

  1. ‌无需安装,直接运行工具
    你可以通过 uvx 直接运行像 ruff(代码检查)、black(代码格式化)、pytest(测试)这样的工具,而无需先用 pip install 安装它们。例如:
1
uvx ruff check .

这条命令会自动下载 ruff 并执行代码检查,运行结束后清理临时环境。

  1. ‌自动创建临时隔离环境
    uvx 在后台会为每次执行创建独立的虚拟环境,确保不会影响系统或项目中的依赖关系,运行完成后自动清除,避免“工具越装越多”的混乱问题。

3.‌支持指定版本,保证一致性‌
可以精确运行某个版本的工具,适合团队协作或 CI 环境中保持行为一致:

1
uvx black==23.12.0 --check .

  1. ‌性能远超传统工具
    由于底层由 Rust 编写,uvx 的依赖解析和安装速度比 pipx 快 10 倍以上,首次运行工具时也能快速完成下载和准备。

  2. ‌适用于多种场景
    临时脚本执行:如生成报告、处理数据
    持续集成(CI/CD):减少构建时间,避免版本冲突
    团队协作:统一工具链版本,提升一致性