一、核心原因分类
docker 二进制不在 sudo 用户的 PATH 环境变量里（最常见）
docker 仅安装了 containerd，没装 docker-ce 客户端
安装路径特殊，/usr/local/bin 未被 sudo 继承
仅 root 能执行，普通用户 sudo 找不到
安装不完整，只装了服务没装客户端
二、分步排查
1. 先确认 docker 本体是否存在
bash
# 直接用root执行，看有没有
su -
docker -v
# 查找二进制文件位置
which docker
find /usr -name docker 2>/dev/null
find /usr/local -name docker 2>/dev/null
正常输出一般是 /usr/bin/docker 或 /usr/local/bin/docker
2. 问题根源：sudo 重置 PATH
Debian 默认 sudo 会清空普通用户 PATH，/usr/local/bin 经常不在 sudo 的搜索路径中。
验证命令：
bash
# 普通用户PATH
echo $PATH
# sudo下的PATH
sudo echo $PATH
对比两者，若 docker 所在目录不在 sudo 的 PATH 里，就会 command not found。
三、修复方案（按推荐优先级）
方案 1：修改 sudoers，保留用户 PATH（推荐）
编辑 sudo 配置
bash
sudo visudo
找到这一行：
Defaults secure_path="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
确认里面包含 /usr/local/bin，如果缺失就补上。
大部分 docker 安装脚本会把二进制放 /usr/local/bin，secure_path 有这个目录 sudo 就能搜到。
可选：保留完整用户 PATH（懒人方案）
找到
Defaults secure_path整行注释掉，新增：
Defaults env_keep+="PATH"
保存退出（Ctrl+O 回车，Ctrl+X），重新执行 sudo docker ps 测试。
方案 2：使用绝对路径执行 docker
先查路径 which docker，假设输出 /usr/local/bin/docker
bash
sudo /usr/local/bin/docker ps
临时可用，适合不想改 sudo 配置的场景。
方案 3：将普通用户加入 docker 组，无需 sudo（最佳长期方案）
docker 设计不建议频繁 sudo，加入组后直接执行 docker 命令：
bash
# 添加用户到docker组
sudo usermod -aG docker $USER
# 刷新组权限（不用重启）
newgrp docker
# 测试，不加sudo
docker ps
原理：docker socket
/var/run/docker.sock归属 docker 组，加入后无需 root 权限。
方案 4：重新完整安装 docker-ce（二进制丢失场景）
如果上面查找不到 docker 二进制，说明安装残缺：
bash
# 卸载残留
apt remove docker docker.io containerd runc -y
# 安装官方完整docker
apt update && apt install ca-certificates curl gnupg lsb-release -y
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
apt update
apt install docker-ce docker-ce-cli containerd.io -y
# 启动并开机自启
systemctl enable --now docker
# 测试
docker -v
sudo docker ps
四、特殊情况：安装了 podman/containerd 但无 docker 客户端
部分源只装 containerd，没有 docker cli：
bash
# 单独安装客户端即可
apt install docker-ce-cli
快速一键修复（加入 docker 组，一劳永逸）
bash
sudo usermod -aG docker $USER && newgrp docker && docker ps原文链接
欢迎访问 小易撩挨踢