根本原因是Shell未将Docker可执行文件路径加入PATH环境变量，需手动添加对应路径并重启终端或IDE；WSL2用户还需启用Docker Desktop的WSL集成；挂载路径错误则多因宿主机路径不存在或权限不足。
docker 命令在终端里报 command not found 怎么办
根本原因不是 Docker Desktop 没装好，而是 Shell 找不到 docker 这个可执行文件的位置。macOS 和 Windows 的 Docker Desktop 安装包默认不会自动把工具路径写进你的 PATH 环境变量。
验证方式很简单：在终端运行 which docker，如果没输出，说明确实不在 PATH 里；再手动查一下安装位置：
ls -l /Applications/Docker.app/Contents/Resources/bin/docker
如果这行能显示文件信息，就确认工具本身是存在的。
- macOS 用户重点检查 Shell 配置文件：
~/.zshrc（Catalina 及以后默认）或~/.bash_profile（旧系统），追加一行：export PATH="/Applications/Docker.app/Contents/Resources/bin:$PATH" - Windows 用户不用改环境变量——Docker Desktop 安装时通常已注册到系统 PATH，但如果用的是便携版或手动解压安装，需手动把
C:\Program Files\Docker\Docker\resources\bin加进系统 PATH - VS Code 内置终端可能读取的是旧 Shell 环境，改完配置后要完全退出 VS Code 再重开，不能只重启终端
IDEA 报 Cannot run program “docker”: CreateProcess error=2 怎么配
这个错误本质和终端里 command not found 是同一类问题：IDEA 没法定位到 docker 可执行文件。它不继承系统 PATH，尤其在较新版本（如 IDEA 2024+）中，默认勾选了 Detect executable paths automatically，但这个自动探测经常失效。
解决方法是关掉自动探测，手动指定路径：
- 打开 Settings → Build, Execution, Deployment → Docker
- 取消勾选
Detect executable paths automatically - 在
Engine API URL下方的Docker path输入框里填入完整路径：/Applications/Docker.app/Contents/Resources/bin/docker（macOS）或C:\Program Files\Docker\Docker\resources\bin\docker.exe（Windows） - 点 Test Connection，看到
Connection Successful才算生效
Windows 上 Docker Desktop 启动后命令仍不可用的隐藏原因
即使 PATH 设置正确、docker --version 在 PowerShell 或 CMD 里能跑，某些场景下依然会失败——比如在 WSL2 终端里直接敲 docker，或者用脚本调用时出错。这不是路径问题，而是 Windows 和 WSL2 之间的二进制桥接没打通。
Docker Desktop 默认只把 docker 注册给 Windows 主机环境，WSL2 发行版里并不自带该命令。你得手动启用 WSL2 集成：
- 打开 Docker Desktop 设置 → Resources → WSL Integration
- 确保
Enable integration with my default WSL distro已勾选，并且目标发行版（如Ubuntu-22.04）右侧开关是开启状态 - 如果之前手动编译过 WSL 内核，注意官方 Docker Desktop 依赖特定内核模块（如
overlay,br_netfilter），缺一个都可能导致docker命令在 WSL2 里静默失败
挂载宿主机路径时提示 no such file or directory 的真实指向
这个错误看似是容器启动失败，但绝大多数时候，它其实是在告诉你：Docker 宿主机侧根本没找到你写的那个路径。比如你在 docker run -v /data/config:/app/conf 里写了 /data/config，而宿主机上这个目录压根不存在，或者权限不对，Docker 就会直接中断启动，而不是帮你创建。
关键检查点：
- 路径必须是绝对路径，不能用
~/或相对路径；在 Docker Desktop for Mac/Windows 中，还要注意宿主机路径是否在允许范围内（例如 macOS 上只能挂载/Users,/Volumes,/private,/tmp） - 先在宿主机上执行
ls -ld /data/config，确认目录存在且当前用户有读写权限；若不存在，运行mkdir -p /data/config - 在 Windows 上使用 WSL2 后端时，路径要写成
/mnt/c/Users/xxx/data格式，而不是C:\Users\xxx\data—— 后者会被当作容器内路径处理
真正容易被忽略的是：这个错误不区分“路径不存在”和“路径存在但无权限”，日志里都统一报 no such file or directory。所以别急着重写命令，先 ls 和 id 两下。
