fix(11.4): COMPOSE_DEBUG=1 不是 Compose 的环境变量

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 才没进文档),故**未改动**。
This commit is contained in:
yeasy
2026-08-07 23:29:17 -07:00
parent 141fdc80bc
commit 33bca896b5
+1 -1
View File
@@ -46,7 +46,7 @@ docker compose [-f=<arg>...] [options] [COMMAND] [ARGS...]
* `-p, --project-name NAME` 指定项目名称默认将使用所在目录名称作为项目名 * `-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` 打印版本并退出 * `-v, --version` 打印版本并退出