卸载 Docker Desktop 后拉取镜像报 docker-credential-desktop 找不到

从 Docker Desktop 切换到独立 Docker Engine 后，docker compose up 在拉取镜像阶段退出：

error getting credentials - err: exec: "docker-credential-desktop": executable file not found in $PATH

这条错误说明客户端尝试启动指定的凭据助手，却没有在自己的 PATH 中找到它。卸载 Desktop 后，客户端配置里仍保留 desktop 助手选择，是需要确认的一种具体原因。它不等于仓库拒绝了账号，也不是应用容器缺少这个程序。

以下针对 Linux 上保留了 Docker CLI 配置的迁移场景。仍在使用 Desktop、只是某个终端或自动化进程 PATH 不同的情况，应先恢复该环境对已安装助手的访问，不要按卸载后的迁移处理。

找到报错客户端实际读取的配置

Docker CLI 默认读取当前用户的 ~/.docker/config.json，但 DOCKER_CONFIG 可以改变目录，命令行 --config 的优先级又高于环境变量。普通用户、sudo、CI 任务可能读取不同文件，必须在真正报错的执行环境中核对。

在该配置中查看 credsStore 和目标仓库的 credHelpers。例如：

{
  "credsStore": "desktop"
}

这是字段示例，不是整份配置的替换内容。值 desktop 对应程序名 docker-credential-desktop；如果 credHelpers 为某个仓库单独指定了助手，它优先于默认 credsStore。只改默认值，不能消除一个仍指向 desktop 的仓库专用设置。

配置可能还含认证和代理信息，不要把整份文件贴到日志或公开问题中。只记录必要的字段名、助手名称和是否存在对应仓库项。

下面只查找程序位置，不读取凭据：

command -v docker-credential-desktop

没有找到时，先区分它已经被卸载，还是实际安装目录未进入该进程的 PATH。也不要把另一个助手简单重命名为 desktop；助手名称背后还有各自的存储服务和初始化要求。

保留原 config.json 的私有备份，再选择适合当前环境的助手。Linux 可使用 pass 或 Secret Service，但装有可执行文件不代表相应的密码存储已经可用。

以 pass 为例，必须先准备好当前用户可使用的 GPG 密钥和已初始化的 pass 存储，并安装能在客户端 PATH 中找到的 docker-credential-pass。现有组织密码存储应沿用其初始化流程，不要为排错随意新建、重置或清空密钥库。

command -v docker-credential-pass
command -v pass

确认存储已经可用后，在原配置里仅调整相关字段，例如：

{
  "credsStore": "pass"
}

保留其他设置，并处理确实属于本次迁移范围的仓库专用 credHelpers 项。JSON 不支持注释，编辑时还需保持逗号和括号正确。Secret Service 则依赖可访问的 D-Bus Secret Service；不能假定无图形会话的任务能访问桌面用户的已解锁存储。

助手切换不会把旧存储中的登录状态自动搬过来。对需要使用的仓库重新认证；下面的账号和仓库均为占位值：

docker login registry.example.com --username your-account

在交互提示中输入适用的密码或访问令牌，不要把令牌写进命令参数。登录、后续拉取以及 Compose 应使用相同用户和配置目录。只有新助手能够保存并在后续调用中取回凭据，迁移才算完成。

删除一个已经失效的默认选择，可能让这条“找不到 desktop”错误消失，但必须同时确认之后使用什么存储。Linux 的默认发现会寻找 pass，找不到时再尝试 secretservice；都没有时，凭据会以 Base64 编码保存在配置文件中。Base64 不是加密。

因此，不要把删除字段当作不改变安全属性的通用修复，也不要把 credsStore 改拼成不受支持的 credStore 来绕过选择。需要长期认证的环境，应先明确并配置能工作的存储。删除整个 .docker 目录还会损失其他客户端配置，更不是修复这一个助手引用所必需的步骤。

登录成功后，使用本来就有读取权限的测试镜像确认后续凭据读取与拉取正常。再恢复原 Compose 流程；compose up 可能创建或更新容器，不能只为测试凭据就对生产项目反复执行。

若错误改为助手无法解锁、GPG 失败或 D-Bus 不可用，说明已经越过程序查找阶段，应处理新存储的会话与初始化问题。若仓库返回认证或授权失败，则继续核对账号、令牌和仓库权限，不要重新删除凭据设置。

需要回退时，先保留当前配置，再恢复备份中的相关字段。恢复 desktop 选择的前提是相应助手和存储也已恢复；只恢复一个指向不存在程序的字段，会让原错误回来。配置回退也不会自动撤销或迁移新存储里的凭据，清理时应只处理明确属于本次测试的登录项。