Docker Compose设置项目名称报错：'name'不匹配正则'^x-'

1. name字段的正确性 #

你在docker-compose.yml顶部添加name: my_project_name的配置方式，在Docker Compose V2及以上版本中是完全正确的。这个字段用于定义全局项目名称，容器启动后会自动生成[项目名]_[服务名]_序号的命名格式（比如你期望的my_project_name_database_1）。

2. 报错的核心原因 #

你遇到的错误本质是当前环境使用的是Docker Compose V1（对应命令为docker-compose，带横杠）。V1完全不支持在yaml文件顶层定义name字段——在V1的规则里，只有以x-开头的自定义扩展字段才允许出现在顶层，所以它会把name判定为非法字段并报错。

哪怕你修改yaml里的version字段也无法解决，因为V1本身就没实现这个功能，该报错和compose文件版本无关。

3. 解决办法 #

办法一：升级到Compose V2 #

V2已集成到Docker CLI中，使用docker compose（空格分隔）命令执行操作。升级后，你的yaml配置无需修改，name字段即可正常生效。

办法二：V1下通过命令行指定项目名 #

如果暂时无法升级，启动容器时可以通过-p参数指定项目名称：

docker-compose -p my_project_name up

这样生成的容器命名格式也能符合你的预期。

办法三：通过环境变量指定 #

设置环境变量COMPOSE_PROJECT_NAME同样可以实现效果：

export COMPOSE_PROJECT_NAME=my_project_name
docker-compose up

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