首页/云/Docker 容器速查/docker images --format 定制输出
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

docker images --format 定制输出

用 Go 模板自定义镜像列表字段(仓库、标签、ID、摘要、体积),适合脚本统计与报表;-q 只输出镜像 ID。

Docker 容器速查云更新于 2026-10-12
用途格式化镜像列表输出
语法--format '{{.字段}} 文本'
常用字段Repository / Tag / ID / Digest / Size / CreatedSince

示例

示例
docker images --format 'table {{.Repository}}	{{.Tag}}	{{.ID}}	{{.Size}}'
docker images --filter 'reference=app/*' --format '{{.Repository}}:{{.Tag}}'
docker images -q --filter 'reference=app/web'
占位符区分大小写;.ID 是 12 位短 ID,跨命令引用同一镜像时要么统一用短 ID,要么改用 inspect 取长 ID。

易错点

  • 把 --format 输出直接拿去做删除等破坏性操作前先人工看一遍,过滤条件写错会命中预期外的镜像
  • 脚本里示例的 \t 由 Docker 模板渲染为制表符,套进二次处理时注意列分隔不要被字段内容破坏

数据来源与参考

  • Docker 官方 CLI 参考:docker image ls 的 format 占位符(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌