docker-compose / docker compose 报 command not found（Compose 没装或没接线）

症状

```

# 形态 1：Desktop shim 在 WSL 里

The command 'docker-compose' could not be found in this WSL 2 distro.

We recommend to activate the WSL integration in Docker Desktop settings.

# 形态 2：原生 CLI 没插件

docker: unknown command: docker compose

Run 'docker --help' for more information

```

特征：`docker` 本体命令正常，只有 compose 相关命令报错；形态 2 是「CLI 在，插件不在」，形态 1 是「Windows 侧 shim 在，WSL 集成/原生插件不在」。

原因

compose 是 docker CLI 的插件（`docker-compose` 二进制放在 CLI 插件目录），不是 docker 本体的一部分。没装插件 = `unknown command`；WSL 里 Desktop shim 命中时给「激活 WSL 集成」的引导文案。修复本质是把 compose 插件装到 CLI 能发现的位置。

解法

1. 原生：`sudo apt-get install -y docker-compose-v2`（Debian/Ubuntu），或官方插件二进制放 `~/.docker/cli-站内文档；

2. Desktop 用户：设置里开 WSL 集成；

3. 验证：`docker compose version`。

验证证据

- 本地实测（2026-08-31，WSL Ubuntu，docker CLI 29.1.3）：

- 链 A（故障）：`docker-compose --version` → `The command 'docker-compose' could not be found in this WSL 2 distro...`（Desktop shim 文案）；`docker compose --help` → `docker: unknown command: docker compose`；

- 链 B（修复）：`apt-get install -y docker-compose-v2`（2.40.3+ds1-0ubuntu1，archive.ubuntu.com）→ `docker compose version` → `Docker Compose version 2.40.3+ds1-0ubuntu1`（exit 0）。

- 实测复现日志（2026-08-31）