Python uv如何查看当前项目的依赖树-Python教程-PHP中文网

uv tree 基于 uv.lock 静态展开依赖树，默认显示一级直接依赖及子依赖，不包含可选依赖；需用 --extra 或 --environment 显式指定 extras 或环境分组，且依赖版本为锁文件中解析出的实际版本。

python uv如何查看当前项目的依赖树

uv tree 查看依赖树的基本用法

直接运行 uv tree 就能生成当前项目的依赖树，前提是项目根目录下存在 pyproject.toml 或 requirements.txt，且已通过 uv lock 或 uv sync 生成过锁文件（uv.lock）。它不会临时解析源码或动态安装，而是基于锁文件做静态展开。

默认只显示一级直接依赖及其子依赖，不展开可选依赖（extra）
如果提示 No lockfile found，先执行 uv lock
依赖版本显示为锁文件中实际解析出的版本，不是 pyproject.toml 中写的模糊范围（如 requests>=2.28）

如何显示可选依赖（extras）和不同环境下的依赖

uv tree 默认忽略 [project.optional-dependencies] 和 [tool.uv.environments] 中定义的环境分组。要查看带 extra 的依赖树，必须显式指定：

查看含 dev extra 的依赖：运行 uv tree --extra dev
查看特定环境（如 test）：需配合 --environment，例如 uv tree --environment test
同时启用多个 extra：用逗号分隔，如 uv tree --extra dev,docs
注意：extra 名称区分大小写，且必须已在 pyproject.toml 中正确定义

常见错误：为什么 uv tree 没有输出或报错

最常遇到的是静默无输出或报 No pyproject.toml or requirements.txt found，本质是 uv 找不到项目元数据入口：

python学习

Python 编程学习助手 skill，面向零基础用户。当用户表达以下意图时触发： - 学习 Python 基础概念（变量、数据类型、循环、函数、类等） - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导（爬虫、数据分析、Web 开发等入门项目） - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill

下载

当前目录不是项目根目录 —— 检查是否存在 pyproject.toml，或用 uv tree --config-file /path/to/pyproject.toml 指定路径
锁文件损坏或格式异常 —— 删除 uv.lock 后重试 uv lock && uv tree
使用了 PEP 621 以外的构建后端（如 setup.py）—— uv tree 目前不支持直接解析 setup.py，需先转成 pyproject.toml
Python 版本不匹配 —— 如果 requires-python = ">=3.11" 但当前解释器是 3.10，uv tree 会跳过该环境，建议用 uv python list 确认可用版本

性能与过滤技巧：快速定位问题依赖

uv tree 解析速度很快，但大型项目仍可能输出几百行。实用过滤方式如下：

只看某个包的依赖链：uv tree | grep -A 5 -B 5 "click"（Linux/macOS）或 uv tree | findstr /C:"click"（Windows）
排除间接依赖，只看直接依赖：uv tree --depth 1
高亮冲突提示（如重复包、版本不兼容）：uv tree --conflicts（需 uv ≥ 0.4.0）
导出为 JSON 方便程序处理：uv tree --format json，注意该输出包含完整解析上下文，体积较大

真正容易被忽略的是：依赖树反映的是锁文件状态，不是当前 site-packages 实际安装内容。如果手动 pip install 过其他包，uv tree 不会体现 —— 它只忠于 uv.lock。