GitHub CLI --attach是什么:2026年9月命令行附图全解析

GitHub 9月1日写:gh v2.99.0 增加可重复的 --attach。Changelog 与 cli/cli 发布说明同一件事:命令行附图进 Issue / PR。Enterprise Server 本版不支持。

2026 年 9 月 1 日,GitHub Changelog 写:GitHub CLI 新增可重复的 --attach。同一天 cli/cli 打上 v2.99.0。两边写的是同一件事:把本地图片或视频写进 Issue、Pull Request 或评论。

此前 gh 只写文本。要加截图,得打开浏览器、拖进评论框、再把托管地址抄回来。Changelog 写:--attach 把图放进写 Markdown 的那条命令。

官方 Changelogv2.99.0谁能用、谁不能

公开条目写了什么

2.99
gh 版本号
9/1
Changelog 日期
6
写出 Markdown 的命令
条目公开写法边界
开关可重复的 --attach不是新的一套 CLI
命令issue / pr 的 create、edit、comment未写其他子命令
体积跟网页上传一致免费视频 10 MB,付费 100 MB
托管GitHub.com 与 Enterprise CloudEnterprise Server 本版不支持

怎么读这次发布

  1. 1

    这是 CLI 补上媒体

    官方写:以前只能写文本。现在同一条命令可以把本地图或视频上传并引用。不要当成新的评审产品。

  2. 2

    正文引用会被改写

    路径已出现在 Markdown 里时,gh 原地换成上传地址并保留 alt。从未引用的附件追加在文末。替代文本可写在路径后的 #。

  3. 3

    令牌没有另开一套

    上传沿用 gh auth login 的 OAuth,或经典 personal access token。对仓库要有写权限。Changelog 点了编码代理也能用这个开关。

  4. 4

    Server 不在本版

    全计划正式可用,没有预览期。v2.99.0 写 GitHub.com 与 Enterprise Cloud。Enterprise Server 被明确排除。

同页还点了什么

01

格式与替代文本

图片:PNG、JPEG、GIF、WebP、SVG。视频:MP4、MOV、WebM。省略 # 说明时,退回文件名。

02

体积跟网页走

图片和 GIF 10 MB。免费计划视频 10 MB,付费计划视频 100 MB。官方写与网页上传相同。

03

文档短链

发布说明指向 gh.io/gh-attach。Changelog 文末有编辑注:9 月 1 日更新了文档链接。

边界

官方没有写 Enterprise Server 的补齐日期。下一步是 Changelog 与 gh.io/gh-attach。需要短会且不想再开一套账号时,回 wbstorm 用房间号即可,另见 创建或加入房间 和 白板基础。

# Sources
# github.blog/changelog/2026-09-01-github-cli-media-in-issues-pull-requests-and-comments
# GitHub cli/cli v2.99.0, 2026-09-01
# CloudNinjas, 2026-09-02
Enterprise Server 能用 --attach 吗?

Changelog 写:本版不支持 GitHub Enterprise Server。v2.99.0 写附件可用在 GitHub.com 与 Enterprise Cloud。

必须开浏览器拖文件吗?

官方写:以前是。现在同一条写 Markdown 的命令可以带 --attach。本文不是逐步教程。

这是产品使用教程吗?

不是。本文只核对 9 月 1 日 Changelog 与 v2.99.0 发布说明,不是 gh 操作手册。

创建房间