首页/云/Docker 容器速查/compose 文件的 version 字段已废弃
Compose 编排55 条

compose 文件的 version 字段已废弃

早期教程里的 version: "3.8" 等字段在 Compose 规范中已经废弃:现代写法直接省略,出现时会在命令输出里收到 obsolete 警告。

Docker 容器速查云更新于 2026-10-12
现状version 字段已废弃
处理直接删除该行
校验docker compose config -q

示例

示例
# 旧写法(会收到 obsolete 警告)
version: "3.8"
services:
  web:
    image: nginx:1.27

# 现写法:省略 version 直接写 services
services:
  web:
    image: nginx:1.27
Compose v2 按最新规范解析文件,所有服务级字段都不再依赖 version 区分能力。

易错点

  • 从教程复制带 version 的文件后,某些新字段(如 develop)可能因旧版本号判定被拒解析
  • 删除 version 时不要顺带改动其它缩进层级,一次只做一件事再校验

数据来源与参考

  • Docker 官方文档:Compose 文件 version 说明(docs.docker.com/compose/compose-file/version-and-name)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌