uv不支持全局更新命令,因其设计哲学强调确定性优先,仅按pyproject.toml或requirements.txt中明确声明的版本约束安装,不跟踪已安装包状态;更新需显式修改依赖声明、重新lock并sync,或临时用uv pip install --upgrade定向升级。

uv 本身不支持“更新所有依赖”这一操作——它没有类似 pip install --upgrade --all 或 poetry update 那样的全局升级命令。
为什么 uv 没有 uv update
uv 的设计哲学是“确定性优先”:它默认只安装 pyproject.toml 或 requirements.txt 中**明确声明的版本约束**,不会主动推导或覆盖已有版本。它不维护本地已安装包的元数据快照,也不跟踪哪些包是“过时的”。所谓“更新”,在 uv 中必须显式触发,且通常通过重写锁文件或修改依赖声明来实现。
用 uv sync --upgrade 强制重装满足最新兼容版本
这是最接近“更新全部依赖”的可行方式,但本质是重新解析整个依赖图,取每个包在当前约束下允许的最新版本(受 pyproject.toml 中的 dependencies 或 requires-python 等限制)。
- 运行前确保你有
uv.lock(或先用uv lock生成),否则--upgrade无意义 -
uv sync --upgrade会忽略 lock 文件中的旧版本,重新计算并安装 - 如果
pyproject.toml写死为"requests==2.28.1",那它永远不会升;只有写成"requests>=2.28.1"或"requests"才可能升级 - 执行后记得检查
uv.lock是否被重写——它是真实生效依据,不是site-packages里的包列表
想升级某个具体包?用 uv pip install --upgrade
uv 提供了 pip 兼容子命令,适用于临时、定向升级:
Python uv 0.12.20 是 Astral 开发的 Python 包与项目管理工具,支持依赖解析、虚拟环境、Python 版本及项目锁文件管理。本下载包适用于 Windows x64,解压后可使用 uv 命令。
uv pip install --upgrade requests flask
注意:
- 这会绕过
pyproject.toml和uv.lock,直接操作当前环境,导致声明与实际不一致 - 后续运行
uv sync可能会把这次升级“覆盖掉”,回到 lock 文件指定的版本 - 仅建议用于调试、临时验证,不要用于长期维护
真正可持续的更新流程:改声明 → 锁定 → 同步
标准做法不是“让工具去猜我要升什么”,而是人先决定哪些约束要放宽或调整:
- 编辑
pyproject.toml,比如把"django~=4.2.0"改成"django>=4.2.0, - 运行
uv lock --upgrade(可加--upgrade-package django升指定包) - 检查生成的
uv.lock,确认新版本符合预期 - 再运行
uv sync应用变更
漏掉 uv lock 这一步,uv sync 就只是重装旧版本——这是最容易被忽略的关键点。

















