uv tree 默认只显示包名不带版本号，需加 --frozen 参数才能显示精确版本（如 requests==2.31.0），用于精准排查依赖冲突；它基于 uv.lock 构建完整依赖树，无锁文件则仅显示直接依赖。
用 uv tree 查看依赖树，但默认不显示版本号
直接运行 uv tree 会输出一个缩进结构的依赖树，但它默认只显示包名，不带版本号——这在排查冲突时容易误判。比如看到 requests → urllib3，但不知道当前装的是 urllib3==2.2.0 还是 2.1.0，而这两个版本对 charset-normalizer 的要求可能完全不同。
要让版本号显式出现，必须加 --frozen 参数：
uv tree --frozen
它会输出类似这样的内容：
requests==2.31.0 ├── charset-normalizer==3.3.2 ├── idna==3.7 ├── urllib3==2.2.0 │ └── brotli==1.1.0 └── certifi==2024.8.30
注意：--frozen 会让所有包都显示精确版本（含哈希校验信息），适合调试；如果只想看语义化版本（如 urllib3>=2.0.0），目前 uv 不支持该粒度，得回退到 uv pip show urllib3 单独查。
uv tree 为什么有时显示不全？检查锁文件和环境状态
常见现象：执行 uv tree 后只看到几个顶层包，或者报错 No lockfile found。这不是命令失效，而是 uv 默认优先基于 uv.lock 构建依赖树——没有锁文件，它就只能按 pyproject.toml 中声明的直接依赖粗略推导，跳过间接依赖。
Python uv 0.12.20 是 Astral 开发的 Python 包与项目管理工具，支持依赖解析、虚拟环境、Python 版本及项目锁文件管理。本下载包适用于 Windows x64，解压后可使用 uv 命令。
- 确保已生成锁文件：
uv lock或uv sync成功执行过 - 确认当前目录下存在
uv.lock（不是requirements.txt） - 若项目用
pip-tools管理，需先转成 uv 格式：uv pip compile requirements.in -o uv.lock - Windows 上 PowerShell 执行失败？换用
cmd或关闭执行策略：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
对比 uv tree 和 uv pip list --outdated 的用途差异
uv tree 解决“谁依赖了谁”，uv pip list --outdated 解决“谁该升级”。两者互补，但不能互相替代：
-
uv tree显示完整层级关系，能一眼看出fastapi为什么拉进了pydantic-core==2.19.2，而你本地手动装的是2.20.0—— 冲突根源就在这里 -
uv pip list --outdated只列出可升级包及其最新兼容版，不告诉你这个“最新版”会不会被某个上游包的requires-python或python-requires拦住 - 想验证某次
uv add --upgrade是否真解决了冲突？先uv lock，再uv tree --frozen | grep 包名确认版本是否已收敛
导出为文本或 JSON 用于自动化分析
人工翻树容易漏，尤其当项目依赖超过 50 层时。可用 --format 输出结构化数据：
uv tree --frozen --format json > deps.json
输出是标准 JSON 数组，每个节点含 name、version、dependencies 字段，可直接喂给 Python 脚本做版本合规检查。注意：--format json 必须配合 --frozen 使用，否则字段缺失。
另一个实用技巧：用 uv tree --no-deps requests 单独查看某个包的直接依赖（不含递归），适合快速确认 requests 当前实际用了哪个 urllib3 版本，而不被整个树淹没。
真正容易被忽略的是：uv 的依赖解析是“锁文件优先”，不是“安装后快照”。哪怕你用 uv pip install 临时装了个包，只要没运行 uv lock，uv tree 就不会把它纳入计算——这点和 pip 的 pipdeptree 行为完全不同。
