最推荐用homebrew安装：已装则执行brew install uv，自动配置path；未装需先运行/bin/bash -c "$(curl -fssl https://raw.githubusercontent.com/homebrew/install/head/install.sh)"安装homebrew，再安装uv；也可直接运行官方脚本curl -lssf https://astral.sh/uv/install.sh | sh，但需手动确保$home/.local/bin在path中。
Homebrew安装最省心，但得先确认是否已装Homebrew
如果你的Mac已经装了Homebrew，brew install uv 是最快、最稳定的方式。它会自动把 uv 放进 /opt/homebrew/bin/uv（M系列芯片）或 /usr/local/bin/uv（Intel），并确保 PATH 可用。
没装 Homebrew？别急着手动下脚本——先运行 which brew 确认；如果返回空，就去官网装一次：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。装完记得重启终端或执行 source ~/.zshrc（默认 shell 是 zsh）。
容易踩的坑：
- Homebrew 安装后不重启终端，
uv --version会报 command not found - 用
sudo装 Homebrew —— 不要这么做，会导致权限混乱，后续brew install可能失败
官方脚本安装适合无Homebrew或需指定版本
跳过 Homebrew 直接跑官方脚本，命令是：curl -LsSf https://astral.sh/uv/install.sh | sh。它会把二进制文件放进 $HOME/.local/bin/uv，并尝试修改 shell 配置文件（如 ~/.zshrc）加一行 export PATH="$HOME/.local/bin:$PATH"。
但这个“尝试”不一定成功：
- 脚本只改
~/.zshrc，如果你用的是bash或fish，得手动补上 PATH 行 - 某些终端（比如 VS Code 内置终端）可能没加载新配置，需要关掉重开，或执行
source ~/.zshrc - 国内网络偶尔卡在下载环节，可加
-v参数看卡在哪：curl -vLsSf https://astral.sh/uv/install.sh | sh
想装特定版本（比如 0.12.1），直接改 URL：curl -LsSf https://astral.sh/uv/0.12.1/install.sh | sh。
验证和更新不能跳过，否则可能用错版本
装完必须立刻验证：uv --version。正常输出类似 uv 0.12.1 (macOS aarch64)。如果报错说找不到命令，90% 是 PATH 没生效；如果版本号很老（比如 0.8.x），说明你可能之前用 pip install uv 装过旧版，而脚本安装的新版被 PATH 顺序压住了。
uv self update 是唯一推荐的升级方式。它会覆盖 $HOME/.local/bin/uv 或 Homebrew 安装的二进制，不碰 Python 环境，也不依赖 pip。别用 pip install --upgrade uv —— 这样装出来的 uv 启动慢、不带内置 Python 管理能力，且容易和系统级 uv 冲突。
注意一个隐藏细节：Homebrew 安装的 uv 默认不响应 uv self update（会提示 “not installed via uv”），得靠 brew upgrade uv 更新。
安装后立即试一个真实操作，避免假成功
光有 uv --version 不代表能用。建议马上跑一句：uv python list。它会连接 Astral 的 Python 下载源，列出可用版本。如果卡住、超时或报 Failed to fetch available Python versions，说明网络或证书有问题，不是 uv 本身坏了。
常见应对：
- 公司网络拦截了
https://github.com/astral-sh/pythons—— 需配代理或换镜像（但 uv 目前不支持自定义 Python 下载源） - macOS 提示“无法打开开发者未签名的应用”——去「系统设置 > 隐私与安全性」底部点“仍要打开”
- 第一次运行
uv python list很慢（几十秒），是正常现象，后续会缓存
真正关键的不是“装上”，而是“能连上 Python 版本源 + 能创建 venv + 能 uv add”。这三步通了，才算落地可用。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
