用 uv 安装和管理 Python 工具链：官方安装器怎么确认成功

准备工作

• macOS / Linux / Windows 任一环境，有终端权限。

• 步骤依据 Astral 官方文档 Installation，核实日期 2026-10-24；安装器脚本与包管理器渠道以文档当前页为准。[1]

操作步骤

1、用官方独立安装器安装

做什么（macOS/Linux 示例）：curl -LsSf https://astral.sh/uv/install.sh | sh

为什么：官方文档把 Standalone installer 列为首选渠道之一，脚本会把 uv 装到用户目录并提示如何把路径加进 PATH。[1]

怎么确认：新开一个终端，执行 uv --version 有版本号输出；若提示 command not found，按安装结束时的 PATH 说明把 bin 目录写进 shell 配置后重开终端。

2、（可选）用包管理器安装

做什么：例如 macOS Homebrew：brew install uv（或其他文档列出的 WinGet/Scoop/MacPorts 等）

为什么：文档提供多种 Installation methods，方便与系统包管理器统一升级。[1]

怎么确认：同样 uv --version；which uv 指向你期望的前缀（brew 前缀或用户目录）。

3、验证能跑 Python 相关命令

做什么：uv python list 或按文档 First steps 执行一次 uv run 示例

为什么：安装成功不只是二进制在，还要确认它能发现/拉取 Python 与执行项目命令。官方把 Installation 之后接到 First steps。[1]

怎么确认：命令退出码为 0，列表或运行输出符合文档预期；无权限/网络错误。

4、升级与卸载按文档对应章节

做什么：升级用文档 Upgrading uv 一节的方法；卸载用 Uninstallation。

为什么：不同安装渠道的升级路径不同，混用容易留下旧二进制。[1]

怎么确认：升级后 uv --version 变化；卸载后 which uv 找不到。

注意事项

• 公司代理环境下，curl 安装脚本可能需要额外证书或镜像策略，以你环境规范为准。

• 不要把安装脚本输出里的 token/路径随手发到公开渠道。

来源

[1] uv Documentation · Installation · https://docs.astral.sh/uv/getting-started/installation/ · 核实于 2026-10-24

#uv #Python #教程 #包管理 #Astral