Docker Compose YAML中部分枚举用短横线-，部分不用的原因

嘿，这个问题问到点子上了！其实本质是YAML语法里「列表（数组）」和「键值对（映射）」的区别，docker-compose完全是根据每个配置项的用途来决定用哪种格式的。咱们逐个拆解你提到的例子：

1. 什么时候不用-？—— 配置项是「单个映射/值」 #

当一个配置项对应单个对象或键值对集合时，不需要用-，直接用key: value的映射格式：

• build：它是用来定义镜像构建规则的单个配置块，比如你可能写：

  build:
    context: .
    dockerfile: Dockerfile.dev
  

  这里build是一个包含多个子键的映射，不是多个独立的构建规则，所以不需要-。
• environment（映射写法）：environment支持两种写法，其中一种是键值对映射，适合清晰定义每个环境变量的键和值，比如：

  environment:
    DB_HOST: db
    DB_PORT: 5432
  

  这种写法不需要-，因为它是一个键值对集合，不是多个独立的变量字符串。

2. 什么时候必须用-？—— 配置项是「多个元素的列表」 #

当一个配置项需要定义多个独立的元素时，必须用-来标记每个列表项，让docker-compose能区分不同的条目：

• ports/volumes：这两个配置项都是列表，因为你可以同时定义多个端口映射或卷挂载。比如：

  ports:
    - "80:80"
    - "443:443"
  volumes:
    - ./app:/usr/src/app
    - db-data:/var/lib/postgresql/data
  

  这里每个-代表一个独立的映射规则，如果移除-，YAML会把这些内容当成语法错误的映射，docker-compose根本解析不了，所以绝对不能移除。
• depends_on：同样是列表，因为一个服务可以依赖多个其他服务（比如同时依赖数据库和缓存服务），-用来标记每个依赖的服务名。如果移除-，你无法同时指定多个依赖项，语法直接报错，所以也不能移除。

3. 为什么db服务的volumes用-、environment不用？ #

这完全是写法选择的问题！environment本身支持两种合法写法：

# 写法1：映射（无-）
environment:
  POSTGRES_USER: admin
  POSTGRES_PASSWORD: secret

# 写法2：列表（有-）
environment:
  - POSTGRES_USER=admin
  - POSTGRES_PASSWORD=secret

db服务的environment用了映射写法，所以没-；而volumes需要定义多个卷（比如本地挂载和命名卷），所以用了列表格式的-。两种写法都是合规的，完全看你自己的习惯或者场景需求。

总结 #

要不要加-，核心看这个配置项是单个映射/值还是多个独立元素的列表：

• 列表类配置（比如ports、volumes、depends_on）必须用-分隔每个元素；
• 映射类配置（比如build、environment的映射写法）不需要-；
• 部分配置项（比如environment）两种写法都支持，可灵活选择。

内容的提问来源于stack exchange，提问作者Basj