docker（及多数 go 编写的 cli 工具）通过重复指定同一标志（如 `--dns 1.1.1.1 --dns 8.8.8.8`）实现列表参数传递，其底层依赖 go `flag` 包对实现了 `flag.value` 接口的自定义类型的支持。
在 Docker 中，--dns=[] 的方括号 [] 并非语法糖或数组字面量，而是文档约定，用于提示该选项支持多次出现以累积值。这正是你成功使用 --dns 127.0.0.1 --dns 8.8.8.8 的原因——Docker 启动时会将这两个值依次注入容器的 /etc/resolv.conf，生成多行 nameserver 条目。
这种设计并非 Docker 特有，而是 Go 标准库 flag 包的通用机制：只要一个类型实现了 flag.Value 接口（即包含 Set(string) error 和 String() string 方法），flag.Parse() 就能自动识别重复出现的同名标志，并对每次出现调用其 Set() 方法，从而实现“追加式”赋值。
以下是一个精简、可运行的示例，展示如何在自己的 Go 程序中复现 Docker 风格的列表参数：
package main
import (
"flag"
"fmt"
"strconv"
"strings"
)
// DNSList 实现 flag.Value，用于收集多个 DNS 地址
type DNSList []string
func (d *DNSList) String() string {
return strings.Join(*d, ", ")
}
func (d *DNSList) Set(value string) error {
if value == "" {
return fmt.Errorf("DNS address cannot be empty")
}
*d = append(*d, value)
return nil
}
func main() {
var dnsServers DNSList
flag.Var(&dnsServers, "dns", "DNS server address (can be specified multiple times)")
flag.Parse()
fmt.Printf("Resolved DNS servers: %v\n", dnsServers)
// 示例输出：Resolved DNS servers: [127.0.0.1 8.8.8.8]
}
编译后运行：
go run main.go --dns 127.0.0.1 --dns 8.8.8.8 # 输出：Resolved DNS servers: [127.0.0.1 8.8.8.8]
⚠️ 注意事项：
- ❌ 不要尝试传入逗号分隔的单字符串（如 --dns "1.1.1.1,8.8.8.8"），这会被视为一个整体地址，导致解析失败；
- ✅ 必须显式重复标志名，这是 Go flag 包的标准行为，也是 Docker、kubectl、etcd 等主流工具的一致实践；
- ? 若需支持更复杂语法（如从文件加载、带端口的 DNS URL），应在 Set() 方法中增强校验与解析逻辑，但接口模式不变；
- ? 该机制与 shell 参数展开无关，完全由 Go 运行时解析，因此在 Bash/Zsh/PowerShell 中行为一致。
总结来说，--dns A --dns B 是官方推荐、语义清晰且工程健壮的方式。它比自定义分隔符更易读、更难出错，也天然兼容 shell 脚本循环和配置管理工具（如 Ansible、Terraform）的列表渲染。理解这一机制，不仅能正确使用 Docker，更能高效开发和调试任何基于 Go flag 的命令行应用。
