核心思路是先解除容器对镜像的引用关系：先用docker ps -a --filter "ancestor=镜像名或id"查关联容器，再docker stop && docker rm或docker rm -f批量清理，最后docker rmi -f删镜像；-f仅跳过引用检查，非暴力硬删。
遇到“镜像被容器占用”无法删除时，核心思路是：先解除容器对镜像的引用关系。强制清理不是跳过依赖，而是主动终止并移除所有关联容器，再删镜像。
确认哪些容器在用这个镜像
运行以下命令，查出所有基于目标镜像启动的容器（包括已停止的）：
- 按镜像名或ID查找：`docker ps -a --filter "ancestor=nginx:latest"` 或 `docker ps -a --filter "ancestor=sha256:abc123..."`
- 只看容器ID便于后续操作：`docker ps -aq --filter "ancestor=nginx:latest"`
一键停止并删除全部关联容器
如果确认这些容器都不需要保留，可直接批量清理：
- 先停再删（推荐，更安全）：`docker stop $(docker ps -aq --filter "ancestor=nginx:latest") && docker rm $(docker ps -aq --filter "ancestor=nginx:latest")`
- 强制一步到位（慎用）：`docker rm -f $(docker ps -aq --filter "ancestor=nginx:latest")`
注意：-f 参数会强行终止运行中容器，可能造成数据丢失，请确保无重要状态或未持久化数据。
删镜像时加 -f 参数绕过引用检查
即使容器已删，有时因缓存或残留引用仍报错。此时可对镜像本身使用强制删除：
- `docker rmi -f nginx:latest`
- `docker rmi -f sha256:abc123...`（推荐用 ID，避免标签歧义）
-f 不代表“暴力硬删”，而是跳过“是否被引用”的校验——前提是容器确实已不存在，否则会失败。
预防下次再卡住的小习惯
日常操作中提前规避依赖问题：
- 构建镜像时加 --rm 参数（如 `docker build --rm -t app:v1 .`），自动清理中间容器
- 定期执行 `docker container prune` 清理已停止容器
- 给测试/临时镜像打明确标签（如
:dev-20260720），避免和正式镜像混淆
