idea docker插件连接失败主因是配置未匹配本地docker监听方式：macos/linux用unix:///var/run/docker.sock或rootless路径，windows用npipe:////./pipe/docker_engine；build需dockerfile在项目根目录或显式指定路径与上下文；push需在idea设置中为registry单独配置凭据并正确tag镜像。
IDEA 自带的 Docker Integration 插件不是“需要额外安装”的功能——Ultimate 版默认启用，Community 版需手动安装，但装完不等于能用，**关键在连接配置是否匹配本地 Docker 实际监听方式**。
为什么 Docker 工具窗口显示 “Connection refused” 或 “No Docker daemon found”
这是最常见卡点，根本原因不是插件没装好，而是 IDEA 找不到正在运行的 Docker 守护进程。Docker Desktop（macOS/Windows）和 Linux 上的 Docker Engine 默认监听位置不同，IDEA 必须精确指向对应 socket 或 TCP 地址。
-
macOS/Linux：默认走 Unix socket，路径是unix:///var/run/docker.sock；若启用了 rootless mode（比如 macOS 4.29+ 或某些 Linux 发行版），实际路径可能是unix:///run/user/1000/docker.sock，需用docker context inspect查确认 -
Windows（Docker Desktop）：优先选npipe:////./pipe/docker_engine；如果启用了 WSL2 后端且想直连 WSL 中的 daemon，才用tcp://localhost:2375，但必须先在 WSL 的/etc/docker/daemon.json里加"hosts": ["tcp://0.0.0.0:2375", "unix:///var/run/docker.sock"]并重启 dockerd - 远程服务器直连？别直接填
tcp://ip:2375就完事——Docker 默认不开放远程 TCP 端口，需修改/etc/docker/daemon.json、重启服务、关防火墙（或放行 2375）、且确保docker info能从 IDEA 所在机器 curl 通该地址
Build Image 时提示 “Cannot find dockerfile” 或构建后镜像没出现在本地列表
IDEA 的 Build Image 功能只认两种路径：一是右键点击的文件必须叫 Dockerfile（大小写敏感，不能是 dockerfile 或 DockerFile）；二是该文件必须位于项目根目录，或你手动指定的相对路径（如 src/main/docker/Dockerfile）——但这个路径必须在 Build 对话框里显式填写，IDEA 不会自动向上递归查找。
- 构建命令实际执行的是
docker build -f <path> -t <name><context></context></name></path>，其中<context></context>默认是Dockerfile所在目录，不是项目根目录。所以如果你把Dockerfile放在src/main/docker/，而target/*.jar在项目根目录下，COPY指令会失败，因为构建上下文里没有target目录 - 解决办法：要么把
Dockerfile移到项目根目录，要么在 Build 对话框里把Context directory改成项目根路径（即.），同时把Dockerfile path设为src/main/docker/Dockerfile - 构建成功后镜像没显示？检查 Docker 工具窗口左上角是否选中了正确的 Docker 连接（比如你配了本地和远程两个，结果构建到了远程，却在本地连接下找）
Push 镜像失败：auth config not found 或 denied: requested access to the resource is denied
IDEA 的 Push 功能不读取 ~/.docker/config.json 里的凭据，它只依赖你在 IDEA 设置里为对应 registry 显式配置的登录信息。
- 进
Settings > Build, Execution, Deployment > Docker > Registry，点击+添加 registry -
Registry URL填完整地址，比如 Harbor 是https://harbor.example.com，阿里云 ACR 是https://<namespace>.registry.aliyuncs.com</namespace>，Nexus 是http://nexus.example.com:8083（注意 Nexus 的 Docker 仓库默认走 8083，不是 8081） - 用户名密码要填对——Harbor 用项目管理员账号，ACR 用 AccessKey ID/Secret，Nexus 用拥有
nx-docker-push权限的用户 - Push 前必须先
docker tag镜像，让镜像名匹配 registry 地址，比如myapp:latest→harbor.example.com/myproject/myapp:latest；IDEA 的 Push 对话框里会自动帮你补前缀，但前提是镜像名里没带斜杠
真正容易被忽略的是：Docker 插件的 Build 和 Push 是两个独立动作，它不会自动帮你 docker tag 或 docker login；而远程部署（比如 SSH 执行 docker run）更不在插件能力范围内——那得靠外部脚本或第三方插件（如 Remote Hosts Access）。别指望点一下就完成从代码到线上容器的全流程。
