用途：在遇到 gcloud 或 bq CLI 的格式化错误、引号转义问题、命令替换失败，或需要调试 CLI 命令时使用，提供常见陷阱的规避与修复思路。
主要能力：
- 命令替换：嵌套管道替换易解析失败，建议拆分为多步，先把中间结果存入变量再使用。
- 引号转义：gcloud logging 时间戳过滤需转义引号，推荐外层用单引号、内层用双引号；JSON 载荷同理。
- BigQuery 查询：简单查询外层用单引号，表名用反引号；复杂多行查询用 heredoc（<<'EOF'）避免转义并防止变量展开。
- 表名格式：bq CLI 参数用 PROJECT:DATASET.TABLE，SQL 内用反引号，含连字符或特殊字符时尤其必要。
- 参数化查询：用 --parameter 传类型化参数，避免注入与复杂转义。
- 多行标志：反斜杠须为行末最后字符，其后不能有空格。
- 重复标志：部分标志只取单值，重复无效，需拆成多条命令。
- 格式输出：--format=json、prettyjson、csv 等，但并非所有命令都支持，先查 --help。
- 调试：gcloud --verbosity=debug、--log-http，bq --dry_run 验证，逐步增加复杂度。
- 特殊情形：transfer config 需同时指定 --transfer_location；CSV 含换行需 --allow_quoted_newlines 等。
使用方式：按上述模式改写命令，优先单引号外层、反引号表名、heredoc 多行查询，并用变量保存可复用值。
适用场景：日常 GCP 运维、日志查询、BigQuery 数据操作与命令调试。
限制：资料未提供安装方式、版本要求、权限配置及收费信息；具体命令支持情况以 --help 为准。