获取帮助

帮助菜单

可以使用 --help 标志查看命令的帮助菜单，例如 uv

$ uv --help

若要查看特定命令的帮助菜单，例如 uv init

$ uv init --help

使用 --help 标志时，uv 会显示精简版帮助菜单。若要查看命令的详细帮助菜单，请使用 uv help

$ uv help

若要查看特定命令的详细帮助菜单，例如 uv init

$ uv help init

使用详细帮助菜单时，uv 会尝试使用 less 或 more 对输出进行“分页”，以便不会一次性全部显示。若要退出分页器，请按 q。

可以使用 -v 标志显示命令的详细输出，例如 uv sync

$ uv sync -v

-v 标志可以重复使用以增加详细程度，例如

$ uv sync -vv

通常，详细输出会包含有关 uv 表现出特定行为原因的额外信息。

在寻求帮助时，确定您所使用的 uv 版本非常重要——有时问题在新版本中已经得到解决。

检查安装版本

$ uv self version

以下命令同样有效

$ uv --version      # Same output as `uv self version`
$ uv -V             # Will not include the build commit and date

注意

在 uv 0.7.0 之前，使用 uv version 而非 uv self version。

参考文档中包含了一份针对常见问题的排查指南。

GitHub 上的问题追踪器 (issue tracker) 是报告错误和请求功能的绝佳场所。请务必先搜索类似问题，因为其他人很可能遇到过相同的问题。

Astral 拥有一个 Discord 服务器，这是提问、深入了解 uv 以及与其他社区成员互动的绝佳场所。