repo 命令大全详解（第十二篇 repo list）

repo list 命令用于列出当前 repo 项目中的所有项目或特定项目的信息。

参数分类及解释

基本参数

• [-f]: 可选参数，表示希望显示完整路径。

  • 示例: repo list -f

• [<project>...]: 可选，指定要列出的特定项目。如果不指定，则列出所有项目。

  • 示例: repo list my_project

• [-r str1 [str2]...]: 可选，使用正则表达式或通配符过滤项目列表。

  • 示例: repo list -r 'my_project.*'

过滤选项

• -g GROUPS, --groups=GROUPS: 根据项目所属的组过滤项目列表。

  • 示例: repo list -g my_group

• -a, --all: 显示所有项目，无论其检出状态如何。

  • 示例: repo list -a

• -n, --name-only: 仅显示仓库的名称。

  • 示例: repo list -n

• -p, --path-only: 仅显示仓库的路径。

  • 示例: repo list -p

• --relative-to=PATH: 显示相对于指定路径的项目路径（默认为repo客户端检出的顶部）。

  • 示例: repo list --relative-to=~/my_workspace

• -f, --fullpath: 显示工作树的完整路径，而不是相对路径。

  • 示例: repo list -f

日志选项

• -h, --help: 显示帮助信息并退出。

  • 示例: repo list --help

• -v, --verbose: 显示所有输出信息。

  • 示例: repo list -v

• -q, --quiet: 仅显示错误信息，抑制正常输出。

  • 示例: repo list -q

多清单选项

• --outer-manifest: 从最外层清单开始操作。

  • 示例: repo list --outer-manifest

• --no-outer-manifest: 不对外部清单操作。

  • 示例: repo list --no-outer-manifest

• --this-manifest-only: 仅对当前（子）清单操作。

  • 示例: repo list --this-manifest-only

• --no-this-manifest-only, --all-manifests: 对当前清单及其子清单进行操作。

  • 示例: repo list --all-manifests

总结

repo list 命令是一个强大的工具，用于查看和过滤当前项目中的所有子项目，支持多种选项以满足不同的显示需求。