执行 docker rmi 失败因镜像被容器（含已停止）引用，需先用 docker ps -a --filter ancestor=镜像名 -q 查容器，再 docker rm -f 批量清理；若无容器则清理 dangling 镜像或构建缓存，最后验证并重试删除。

当执行 docker rmi 删除镜像时提示“image is being used by running container”，说明该镜像正被一个或多个容器（包括已停止的）引用，必须先清理相关容器才能成功删除。

确认哪些容器在使用该镜像

运行以下命令查看所有基于目标镜像启动的容器（含已停止的）：

docker ps -a --filter ancestor=镜像名或ID -q

例如：docker ps -a --filter ancestor=nginx:alpine -q，会输出匹配容器的ID列表。若无输出，说明没有容器依赖该镜像，问题可能出在 dangling 镜像或构建缓存上。

批量删除关联容器（谨慎操作）

如果确认这些容器不再需要，可直接删除：

• 停止并删除所有匹配容器：docker rm -f $(docker ps -a --filter ancestor=镜像名 -q)
• 只删已停止的容器（跳过运行中）：docker rm $(docker ps -a --filter status=exited --filter ancestor=镜像名 -q)

⚠️ 注意：-f 会强制终止运行中容器，请确保无重要数据未保存。

检查并清理构建缓存与悬空镜像

有时镜像被“构建缓存”隐式引用，即使没有容器也在占用。可尝试：

• 清理所有悬空镜像（<none></none> 标签）：docker image prune
• 清理构建缓存（Docker 20.10+）：docker builder prune
• 彻底清理（含已停止容器、网络、缓存）：docker system prune -a（慎用，会删所有未使用的资源）

验证并再次删除镜像

执行完上述步骤后，重新运行：

docker rmi 镜像名或ID

如仍失败，可用 docker image inspect 镜像ID 查看 RepoTags 和 ParentId，确认是否为中间层镜像——这类镜像无法直接删除，需删掉顶层镜像后自动释放。