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 的那条命令。
公开条目写了什么
| 条目 | 公开写法 | 边界 |
|---|---|---|
| 开关 | 可重复的 --attach | 不是新的一套 CLI |
| 命令 | issue / pr 的 create、edit、comment | 未写其他子命令 |
| 体积 | 跟网页上传一致 | 免费视频 10 MB,付费 100 MB |
| 托管 | GitHub.com 与 Enterprise Cloud | Enterprise Server 本版不支持 |
怎么读这次发布
- 1
这是 CLI 补上媒体
官方写:以前只能写文本。现在同一条命令可以把本地图或视频上传并引用。不要当成新的评审产品。
- 2
正文引用会被改写
路径已出现在 Markdown 里时,gh 原地换成上传地址并保留 alt。从未引用的附件追加在文末。替代文本可写在路径后的 #。
- 3
令牌没有另开一套
上传沿用 gh auth login 的 OAuth,或经典 personal access token。对仓库要有写权限。Changelog 点了编码代理也能用这个开关。
- 4
Server 不在本版
全计划正式可用,没有预览期。v2.99.0 写 GitHub.com 与 Enterprise Cloud。Enterprise Server 被明确排除。
同页还点了什么
格式与替代文本
图片:PNG、JPEG、GIF、WebP、SVG。视频:MP4、MOV、WebM。省略 # 说明时,退回文件名。
体积跟网页走
图片和 GIF 10 MB。免费计划视频 10 MB,付费计划视频 100 MB。官方写与网页上传相同。
文档短链
发布说明指向 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-02Enterprise Server 能用 --attach 吗?
Changelog 写:本版不支持 GitHub Enterprise Server。v2.99.0 写附件可用在 GitHub.com 与 Enterprise Cloud。
必须开浏览器拖文件吗?
官方写:以前是。现在同一条写 Markdown 的命令可以带 --attach。本文不是逐步教程。
这是产品使用教程吗?
不是。本文只核对 9 月 1 日 Changelog 与 v2.99.0 发布说明,不是 gh 操作手册。