.NET7中如何通过dotnet publish命令传入ContainerEnvironmentVariable参数

在.NET7里用dotnet publish直接构建Docker容器时，-p:ContainerEnvironmentVariable参数用来给容器设置环境变量，下面是不同场景下的正确用法：

单个环境变量 #

直接传入键=值格式的字符串，用引号包裹避免解析问题：

dotnet publish --os linux --arch x64 -p:ContainerImageName=MyContainer -p:ContainerEnvironmentVariable="ASPNETCORE_ENVIRONMENT=Production" -c Release

多个环境变量 #

多个变量之间用分号分隔，注意不同终端的引号使用：

• Windows命令提示符（CMD）：直接用双引号包裹所有变量

  dotnet publish --os linux --arch x64 -p:ContainerImageName=MyContainer -p:ContainerEnvironmentVariable="ASPNETCORE_ENVIRONMENT=Production;CONNECTION_STRING=Server=db;Database=AppDb" -c Release
  

• Linux/macOS的Bash/Zsh：用单引号包裹，防止分号被终端解析为命令分隔符

  dotnet publish --os linux --arch x64 -p:ContainerImageName=MyContainer -p:ContainerEnvironmentVariable='ASPNETCORE_ENVIRONMENT=Production;CONNECTION_STRING=Server=db;Database=AppDb' -c Release
  

含特殊字符的环境变量 #

如果变量值包含空格、引号或其他特殊字符，需要对特殊字符转义，或者用嵌套引号：

dotnet publish --os linux --arch x64 -p:ContainerImageName=MyContainer -p:ContainerEnvironmentVariable="APP_MESSAGE=\"Hello from .NET Docker\"" -c Release

原理说明 #

这个参数会直接在生成的Dockerfile中添加ENV指令，比如传入ASPNETCORE_ENVIRONMENT=Production，Dockerfile里会生成：

ENV ASPNETCORE_ENVIRONMENT=Production

多个变量的话，会拆分成多个ENV指令或者合并成一行，最终效果和在Dockerfile里手动写ENV一致。

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