repo 命令大全详解（第十一篇 repo init）

repo forall 命令用于在指定的项目上执行给定的命令，非常适合批量操作。

参数分类及解释

基本参数

• [<project>...]: 可选，指定要操作的项目。如果不指定，则对所有项目执行命令。

  • 示例: repo forall my_project -c "git status"

• -c <command>: 必需，指定要在每个匹配项目上执行的命令。

  • 示例: repo forall -c "git pull"

选项

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

  • 示例: repo forall --help

• -j JOBS, --jobs=JOBS: 设置并行执行的作业数量（默认值为 8）。

  • 示例: repo forall -j 4 -c "git fetch"

• -r, --regex: 仅在与正则表达式或通配符匹配的项目上执行命令。

  • 示例: repo forall -r my_project.* -c "git status"

• -i, --inverse-regex: 仅在不匹配正则表达式或通配符的项目上执行命令。

  • 示例: repo forall -i my_project.* -c "git status"

• -g GROUPS, --groups=GROUPS: 仅在匹配指定组的项目上执行命令。

  • 示例: repo forall -g my_group -c "git clean -fd"

• -e, --abort-on-errors: 如果命令未成功退出，则中止操作。

  • 示例: repo forall -e -c "git push"

• --ignore-missing: 忽略缺失的检出，正常退出而不报错。

  • 示例: repo forall --ignore-missing -c "git status"

• --interactive: 强制交互式使用，适用于需要用户确认的命令。

  • 示例: repo forall --interactive -c "git push"

日志选项

• -v, --verbose: 显示所有输出信息，包括详细的操作过程。

  • 示例: repo forall -v -c "git status"

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

  • 示例: repo forall -q -c "git status"

• -p: 在输出之前显示项目标题，方便区分不同项目的输出。

  • 示例: repo forall -p -c "git status"

多清单选项

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

  • 示例: repo forall --outer-manifest -c "git status"

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

  • 示例: repo forall --no-outer-manifest -c "git status"

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

  • 示例: repo forall --this-manifest-only -c "git status"

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

  • 示例: repo forall --all-manifests -c "git status"

总结

repo forall 命令是一个强大的工具，能够在多个项目中批量执行命令，支持多种选项以提高灵活性和控制力，非常适合团队开发中的管理和维护工作。