如何从.env文件读取环境变量到docker-compose.yml？配置后变量未被识别

兄弟，我之前也踩过这个坑！你遇到的问题核心是没分清Docker Compose解析配置时依赖的变量和容器运行时可用的变量这俩的区别，下面给你拆解几个关键排查点和解决办法：

1. 搞清楚两个变量来源的差异 #

• 你在docker-compose.yml里通过env_file: ./app.env配置的变量，只会传给容器运行时使用，不会被Compose本身用来解析yml里的插值（比如environment: NEW_VAR=${OLD_VAR}_suffix这种写法）。
• Compose解析yml时用的变量，优先级是：系统环境变量 > 当前目录下默认的.env文件 > 用--env-file参数指定的文件。

所以如果你的OLD_VAR只在app.env里，Compose解析${OLD_VAR}时根本找不到这个变量，自然插值失败。

2. 针对性解决办法 #

方法一：让Compose加载你的app.env文件 #

运行Compose命令时显式指定--env-file参数，这样Compose解析yml时会读取app.env里的变量：

docker-compose --env-file app.env up -d

方法二：把app.env改名为默认的.env #

Compose默认会加载当前目录下的.env文件作为自身解析配置的变量来源，改个文件名就能省掉每次加参数的麻烦：

mv app.env .env

之后直接运行docker-compose up -d就行。

方法三：在yml中直接传递容器内的变量插值（适用于容器内部使用的场景） #

如果你的插值是要在容器内部的命令/脚本中使用，不需要在Compose解析时替换，那可以把变量引用交给容器的shell处理：
比如修改docker-compose.yml：

version: '3.8'
services:
  your-app:
    env_file: ./app.env
    # 用sh -c让容器shell解析变量
    command: sh -c 'echo "组合后的变量: ${OLD_VAR}_suffix"'

这种情况下，OLD_VAR只要在app.env里，容器启动后shell会自动解析插值。

3. 必查的细节坑 #

• 变量格式要规范：.env文件里的变量不能有空格，比如OLD_VAR=hello是对的，OLD_VAR = hello或者OLD_VAR="hello"（无特殊需求别加引号）会导致变量识别失败。
• 注释别乱加：注释必须单独占一行，用#开头，不能写在变量行后面，比如OLD_VAR=hello # 这是注释会把# 这是注释也当成变量值的一部分。
• 大小写敏感：Docker Compose对变量名大小写严格区分，OLD_VAR和old_var是两个完全不同的变量。

4. 验证配置是否正确 #

运行下面的命令可以查看Compose解析后的完整配置，直接检查变量插值是否生效：

# 如果用了--env-file参数，要带上
docker-compose --env-file app.env config

如果输出里的environment字段显示的是正确的组合值，说明配置没问题。

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