查看 uv 的运行日志，需要在命令行中为 uv 命令添加 --verbose 或 -v 参数。该参数会输出详细的执行过程信息，包括解析依赖、下载包和安装步骤等。若需更底层的调试信息，可叠加使用 --verbose 多次，如 -vv 或 -vvv。
如何查看 uv 的详细执行过程
要查看 uv 的详细执行过程，只需在命令后追加 -v 标志即可。例如运行 uv pip install requests -v，终端将打印出每一步的操作细节，如正在检查哪个索引源、下载了哪些文件以及校验和是否匹配。这有助于排查网络问题或依赖冲突。
uv pip install requests -v # 输出示例： # INFO uv::resolver: Resolving dependencies... # INFO uv::client: Fetching https://pypi.org/simple/requests/ # INFO uv::download: Downloading requests-2.31.0-py3-none-any.whl (62 kB)
如何获取最底层的调试信息
当常规详细日志不足以定位问题时，可以使用 -vvv 参数获取最底层的调试信息。这会启用 Rust 层面的日志记录，显示内部状态机转换、缓存命中情况以及具体的 HTTP 请求头。适用于深入分析 uv 自身行为异常的情况。
uv pip install requests -vvv # 输出示例： # DEBUG uv::cache: Cache hit for requests-2.31.0 # DEBUG reqwest::connect: connecting to pypi.org:443 # DEBUG hyper::client::conn: incoming body is finished
基于 uv 安装失败时的具体日志分析问题
当 uv 安装失败时，日志中通常会包含具体的错误原因，如网络超时、权限不足或依赖版本冲突。通过观察 -v 输出的最后几行，可以快速定位问题所在。例如，若看到 ERROR: Could not find a version that satisfies the requirement...，则说明依赖解析失败。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
