From 33bca896b523889d578a29f60fac1082e84d8ceb Mon Sep 17 00:00:00 2001 From: yeasy Date: Fri, 7 Aug 2026 23:29:17 -0700 Subject: [PATCH] =?UTF-8?q?fix(11.4):=20COMPOSE=5FDEBUG=3D1=20=E4=B8=8D?= =?UTF-8?q?=E6=98=AF=20Compose=20=E7=9A=84=E7=8E=AF=E5=A2=83=E5=8F=98?= =?UTF-8?q?=E9=87=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 11.4.2 让读者在 V2 里改用 `COMPOSE_DEBUG=1` 打开调试输出，但这个变量既不在官方 [Compose 环境变量清单](https://docs.docker.com/compose/how-tos/environment-variables/envvars/) 里（该页只有 COMPOSE_PROJECT_NAME、COMPOSE_FILE、COMPOSE_PROFILES … COMPOSE_PROGRESS 等 15 个），在 docker/compose 源码里也搜不到——照做不会有任何效果。 同时 `--verbose` 的定性收紧一档：源码 cmd/compose/compose.go 里它仍会 `logrus.SetLevel(logrus.TraceLevel)`，只是被 `MarkHidden("verbose")` 从 --help 里 藏起来了，并没有像 `--no-ansi` 那样被标 DEPRECATED，所以说"已弃用"不准确。 另：同节下一行的 `-v, --version` 经核实是对的，虽然官方文档的 global options 表里 没有它，但源码 `c.Flags().BoolVarP(&version, "version", "v", ...)` 确实注册了该短选项 （同样是 MarkHidden 才没进文档），故**未改动**。 --- 11_compose/11.4_commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/11_compose/11.4_commands.md b/11_compose/11.4_commands.md index 740fece..6b9c6ea 100644 --- a/11_compose/11.4_commands.md +++ b/11_compose/11.4_commands.md @@ -46,7 +46,7 @@ docker compose [-f=...] [options] [COMMAND] [ARGS...] * `-p, --project-name NAME` 指定项目名称，默认将使用所在目录名称作为项目名。 -* `--verbose` 输出更多调试信息。(**已弃用**：在 Docker Compose V2 中，请改用 `docker --log-level debug compose ...` 或设置环境变量 `COMPOSE_DEBUG=1`。) +* `--verbose` 输出更多调试信息。(Compose V2 中该选项仍然生效，但已从 `--help` 中隐藏，不再是推荐用法；请改用 `docker --log-level debug compose ...`。) * `-v, --version` 打印版本并退出。