有时“展示“比“解释“更有效。我们确信本次更新将助力实现这一点。

GitHub CLI 新增了可重复使用的 --attach 参数，可直接上传本地图片或视频，并将其内联引用至议题、拉取请求或评论正文中。

此功能现已面向 GitHub 所有计划的用户全面开放。 https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/…

GitHub CLI：在议题、拉取请求与评论中使用媒体

来源：https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/ GitHub CLI 现已支持可重复使用的 --attach 参数，可上传本地图片或视频，并在议题、拉取请求或评论正文中内联引用。

此功能现已面向 GitHub 所有计划的用户全面开放。您只需将 gh 更新至 v2.99.0 版本即可。

此功能为何重要？(https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/#why-this-matters)

某些情况“展示“比“描述“更直观（例如：UI 缺陷、渲染结果、屏幕错误）。此前 gh 仅支持文本输出，添加图片或视频至议题或拉取请求时，需切换至浏览器，将文件拖入评论框，再将内容复制回来。现在，gh 可直接从命令行附加图片与视频。

--attach 参数可将图片嵌入撰写 Markdown 的同一命令中。提交缺陷报告时截图可一同附上，确保议题首次提交即呈现真实问题。创建包含前后对比的拉取请求时，审阅者可直接查看变更，无需拉取分支检查。编程助手同样支持此功能，可直观展示结果而非文字描述。

功能特性 (https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/#capabilities)

• 在编写 Markdown 文本的命令中附加文件： --attach 参数支持重复使用，适用于 gh issue create、gh issue edit、gh issue comment、gh pr create、gh pr edit 及 gh pr comment 命令。
• 保持 Markdown 原始编写状态： 正文中已引用的本地路径将就地替换，因此 ![alt](./login.png) 会保留替代文本并转为已上传资源。未被引用的附加文件将自动追加至末尾。
• 支持图片与视频： 兼容 PNG、JPEG、GIF、WebP、SVG、MP4、MOV 及 WebM 格式。
• 为附加内容添加描述： 替代文本可紧跟路径后使用 # 指定，例如 --attach './login.png#登录错误状态'。省略时 gh 会自动使用文件名。

安全与访问控制 (https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/#security-and-access-controls)

上传认证沿用 gh 已有的常规令牌类型，包括 gh auth login 的 OAuth 令牌或经典个人访问令牌。向目标仓库附加文件需具备写入权限。

--attach 现已面向所有计划的 GitHub 用户全面开放，无预览期。文件大小限制与网页上传流程一致：免费计划中图片与 GIF 限 10MB，视频限 10MB；付费计划中视频限 100MB。本次发布暂不支持 GitHub Enterprise Server。

开始使用 (https://github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments/#getting-started)

将 gh 更新至 v2.99.0 后，执行 gh issue comment --attach ./screenshot.png 即可使用。--attach 在 gh issue 和 gh pr 的创建、编辑及评论命令中用法一致。运行 gh help 可查看完整参数说明。

终端演示 gh issue comment 命令通过 --attach 上传 empty-state.png 并返回议题评论 URL 的示例。

加入 GitHub 社区讨论(https://github.com/orgs/community/discussions/205787)并阅读文档(https://docs.github.com/en/github-cli/github-cli/attaching-files-with-github-cli)了解更多命令行附件功能。

编辑注（2026年9月1日）：已更新文档链接。