Ubuntu 22.04下执行Docker容器命令时提示com.docker.cli不在PATH的问题

这个错误在Ubuntu 22.04中执行docker ps -a、docker container ls等命令时触发，普通用户和root身份操作都会出现，核心原因是Docker CLI组件缺失、损坏，或是安装方式导致的路径配置异常。下面是具体解决步骤：

1. 确认Docker安装方式 #

先判断Docker是通过snap还是apt安装的：

• 检查snap安装：执行snap list | grep docker，有输出则为snap安装；
• 检查apt安装：执行dpkg -l | grep docker，有输出则为apt安装。

2. 处理snap安装的Docker #

snap版Docker容易出现这类路径问题，建议卸载后改用官方apt源重新安装：

# 卸载snap版Docker
sudo snap remove docker

# 清理残留的Docker相关包
sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras

# 删除Docker残留数据目录
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

# 添加Docker官方GPG密钥
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# 添加官方软件源到系统配置
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装完整Docker套件
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 将当前用户加入docker组，避免每次操作都用sudo
sudo usermod -aG docker $USER

执行完成后重新登录系统，让组权限生效。

3. 处理apt安装的Docker #

如果是apt安装的，先尝试重新安装CLI组件：

sudo apt-get reinstall docker-ce-cli

如果报错依旧，就按照上面的“清理残留包→删除数据目录→重新安装”流程操作。

4. 验证修复 #

重新登录后执行docker ps -a，如果能正常显示容器列表，说明问题已解决。

内容的提问来源于stack exchange，提问作者Kristina