如何使用GitHub的gh工具在PR评审中添加代码行内注释？

v2.0及以上版本的gh CLI原生支持该能力，未找到对应用法通常是因为行评参数没有在帮助文档的显眼位置标注。
使用gh pr review命令即可将行级评论和最终评审结论（批准/请求修改/仅评论）打包为一次完整评审提交，和网页端操作效果完全一致。核心用法是通过重复传入--comment参数指定每条行评，参数格式为文件相对路径:行号:代码侧:评论内容，其中代码侧填RIGHT代表评论PR变更后的代码行，填LEFT代表评论PR基线版本的代码行。
示例命令（批准PR同时提交行评）：

gh pr review 123 \
  --approve \
  --body "整体评审结论：符合合入要求，细节优化点见行内评论" \
  --comment "src/data_process.cpp:42:RIGHT:架构设计合理，但请将`std::vector<std::uint8_t> hugedata`以`const &`形式传参，避免产生不必要的拷贝。"

如果需要提交多条行评，直接追加多个--comment参数即可。

如果使用v2.0以下的旧版本gh，或者需要实现更自定义的评审逻辑，可以直接调用GitHub PR评审相关接口完成，步骤如下：

• 第一步：获取目标PR的最新头提交SHA，可直接通过gh命令快速获取，无需额外鉴权处理：

  gh pr view <你的PR编号> --json headRefOid --jq .headRefOid
  

• 第二步：构造评审请求体，需要包含三部分核心内容：评审顶层正文、最终评审事件（APPROVE对应批准、REQUEST_CHANGES对应驳回要求修改、COMMENT对应仅留评论）、行级评论数组。每条行级评论需要指定文件路径、对应行号、代码侧、评论内容。
  示例请求体JSON：

  {
    "body": "整体评审结论：符合合入要求，细节优化点见行内评论",
    "event": "APPROVE",
    "comments": [
      {
        "path": "src/data_process.cpp",
        "line": 42,
        "side": "RIGHT",
        "body": "架构设计合理，但请将`std::vector<std::uint8_t> hugedata`以`const &`形式传参，避免产生不必要的拷贝。"
      }
    ]
  }
  

• 第三步：提交请求，直接使用gh内置的api调用能力即可自动复用本地已登录的gh鉴权信息，不需要手动处理Token：

  gh api repos/{仓库所属用户名}/{仓库名}/pulls/{PR编号}/reviews --input @你保存的请求体文件路径.json
  

注意：传入的行号必须和PR diff中对应侧的行号完全匹配，否则接口会返回参数错误。

内容的提问来源于stack exchange，提问作者Marcus Müller