uv版本过旧导致命令报错，需按安装方式选择升级路径：脚本安装用uv self update，pip/brew/winget等则对应使用各自包管理器升级命令。
你的 uv 命令行工具卡在旧版本，执行 uv python install 报错提示 required-version 不满足，或者团队新项目跑不起来，根本原因是本地 uv 二进制没更新到最新版——不同安装方式对应不同的升级路径，走错一步就卡死。
先确认你用哪种方式装的 uv
打开终端，运行这行命令：
uv --version
再看你是怎么装的：如果当初是用 curl ... | sh（Mac/Linux）或 irm ... | iex（Windows PowerShell）一键脚本装的，那它支持 uv self update；如果是用 pip install uv、brew install uv、winget install 或 cargo install 装的，uv self update 会直接报错“no receipt found”，必须换对应包管理器的命令。
独立脚本安装用户：一行命令升最新版
这是最干净的方式，适用于用官方脚本安装的用户：
第一步：直接运行自更新命令
uv self update
它会自动检测 GitHub 最新 release 版本，下载对应平台的二进制文件，覆盖原安装位置。已有的缓存、虚拟环境、Python 托管版本全部保留，不会被清空或重置。
⚠️ 注意：【该操作会重新写入 shell 配置文件（如 ~/.zshrc 或 PowerShell profile），可能重复添加 PATH】。如果你之前手动改过 PATH 或用了其他工具管理路径，建议加环境变量屏蔽干扰：
UV_NO_MODIFY_PATH=1 uv self update
想提前知道要升到哪个版本？加 --dry-run 看预览：
uv self update --dry-run
非独立脚本安装用户：按来源选命令
方法一：pip 安装的 → 用 pip 升
pip install --upgrade uv
方法二：Homebrew 安装的 → 用 brew 升
brew upgrade uv
方法三：Windows winget 用户 → 用 winget 升
winget upgrade astral-sh.uv
方法四：Scoop 用户 → 用 scoop 升
scoop update uv
方法五：cargo 构建安装的 → 重装锁定版
cargo install --locked uv
这步会从 crates.io 拉取最新稳定版源码并编译，耗时较长但可确保 ABI 兼容性。若本地 Rust 工具链未就绪，会报错退出，此时应优先改用官方脚本重装。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
