# docker image inspect

显示一个或多个镜像的详细信息。

## 用法

```bash
docker image inspect [OPTIONS] IMAGE [IMAGE...]
```

该命令返回有关指定镜像的底层信息，包括其配置、元数据、层（layers）、创建时间、环境变量、入口点（Entrypoint）、工作目录（WorkingDir）等。输出默认为 JSON 格式。

你可以使用 `--format`（或 `-f`）选项来自定义输出格式，例如只提取特定字段。

## 选项

\| 短选项 | 长选项 | 默认值 | 描述 | | | ---- | | | | `-f` | `--format` | 无 | 使用自定义 Go 模板格式化输出： • `'json'`：以紧凑 JSON 格式输出 • `'TEMPLATE'`：使用 Go 模板语法输出特定字段 更多格式化说明请参阅：<https://docs.docker.com/go/formatting/> |

## 示例

### 1. 查看镜像的完整信息（JSON 格式）

```shellscript
docker image inspect nginx:latest
```

输出为包含所有镜像元数据的 JSON 数组（即使只查一个镜像，也会返回数组）。

### 2. 仅获取镜像 ID

```shellscript
$ docker image inspect --format='{{.Id}}' nginx:latest
sha256:605c77e624ddb75e6110f997c58876baa13f11cd244fd88e9a62403644a3bfa4
```

### 3. 获取镜像的架构和操作系统

```bash
$ docker image inspect --format='{{.Architecture}}/{{.Os}}' alpine
amd64/linux
```

### 4. 获取镜像的创建时间

```bash
$ docker image inspect --format='{{.Created}}' ubuntu
2024-03-15T01:23:45.678901234Z
```

### 5. 批量检查多个镜像

```bash
$ docker image inspect nginx:latest redis:alpine --format='{{.RepoTags}} {{.Size}}'
[nginx:latest] 142000000
[redis:alpine] 32500000
```

> 💡 注意：`RepoTags` 是一个字符串数组，因此在模板中会以 `[tag1 tag2]` 形式显示。