返回专栏
· 22 分钟阅读

环境变量与运行环境


一、什么是环境变量与运行环境?

程序并不是在完全独立的条件下运行的。它通常需要依赖操作系统、运行时、配置文件、网络服务、数据库、文件系统以及其他外部资源。

这些外部条件共同构成了程序的运行环境。

在运行环境中,环境变量是一种非常常见的配置传递机制。

1. 什么是环境变量?

环境变量(Environment Variable) 是操作系统进程环境中的一组键值对,用于向程序及其子进程传递配置信息。

例如:

APP_ENV=production
PORT=8080
LOG_LEVEL=info
DATABASE_HOST=127.0.0.1

其中:

  • APP_ENV:表示当前应用环境。
  • PORT:表示应用监听端口。
  • LOG_LEVEL:表示日志级别。
  • DATABASE_HOST:表示数据库主机地址。

程序启动时可以读取这些变量,根据不同配置调整自身行为。

例如,同一个程序可以通过不同环境变量连接不同数据库,而不需要修改源代码。

2. 什么是运行环境?

运行环境(Runtime Environment) 是程序执行所依赖的软件、系统配置和资源条件的集合。

它通常包括:

  • 操作系统及其版本。
  • CPU 架构。
  • 编程语言运行时。
  • 虚拟机或解释器。
  • 系统库和动态链接库。
  • 环境变量。
  • 配置文件。
  • 网络和文件系统。
  • 数据库、消息队列等外部服务。
  • 用户权限和安全策略。

例如,一个 Java Web 应用的运行环境可能包括:

Linux
├── JDK 17
├── Spring Boot 应用
├── JVM 参数
├── 环境变量
├── 数据库连接配置
├── 日志配置
└── 网络与文件系统

环境变量只是运行环境的一部分,不能将二者等同。

3. 环境变量与运行环境的关系

对比维度 环境变量 运行环境
本质 键值对配置 程序执行条件的集合
作用 向程序传递外部信息 提供程序执行所需条件
内容 字符串形式的变量 操作系统、运行时、配置、资源等
生命周期 通常与进程及其环境相关 取决于系统和运行资源的生命周期
管理方式 Shell、系统服务、容器、CI/CD 操作系统、运行时、容器、部署平台
典型示例 PATH、PORT、APP_ENV Linux、JVM、Node.js、数据库

二者之间的关系可以概括为:

flowchart TD
    A["运行环境"] --> B["操作系统"]
    A --> C["语言运行时"]
    A --> D["系统依赖与资源"]
    A --> E["配置管理"]
    E --> F["环境变量"]
    E --> G["配置文件"]
    F --> H["应用程序"]
    G --> H
    B --> H
    C --> H
    D --> H

    style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style B fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style C fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style D fill:#E8EDF2,stroke:#B8C3CE,color:#334155
    style E fill:#FFF5DE,stroke:#E8D29A,color:#334155
    style F fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style G fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style H fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    linkStyle default stroke:#A3B8AC,stroke-width:1.5px

二、环境变量的基本原理

环境变量并不是由应用程序自行随意创建的一组全局变量,而是操作系统提供的一种进程环境机制。

在类 Unix 系统中,进程通常可以通过环境字符串数组访问环境变量。

1. 环境变量的存储形式

环境变量通常采用以下形式:

KEY=VALUE

例如:

PATH=/usr/local/bin:/usr/bin:/bin
HOME=/home/user
LANG=zh_CN.UTF-8

其中:

  • KEY 是变量名称。
  • VALUE 是变量值。
  • = 用于分隔名称和值。

环境变量的值通常以字符串形式传递。

即使变量表示数字、布尔值或路径,程序读取后也通常需要自行解析。

例如:

PORT=8080
DEBUG=true

程序读取后需要决定:

  • PORT 是否转换为整数。
  • DEBUG 应该按照什么规则解析为布尔值。
  • 配置缺失时使用什么默认值。

2. 进程环境(Process Environment)

在类 Unix 系统中,进程可以拥有自己的环境变量集合。

进程启动时,操作系统会将环境信息传递给新程序。

在 C 语言中,可以通过 environ 或 getenv() 访问环境变量。

示例:

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *env = getenv("APP_ENV");

    if (env != NULL) {
        printf("Environment: %s\n", env);
    } else {
        printf("APP_ENV is not set\n");
    }

    return 0;
}

运行:

APP_ENV=production ./app

输出:

Environment: production

这里的 APP_ENV=production 只对本次启动的进程及其后续环境传递产生影响,不会自动修改系统中所有进程的环境变量。

3. 父进程与子进程的环境变量继承

进程创建时,子进程通常可以继承父进程的环境变量。

在 Unix/Linux 中,典型情况是:

  1. Shell 保存当前环境变量。
  2. Shell 启动子进程。
  3. 子进程获得环境变量副本。
  4. 子进程读取自己的环境变量。
  5. 子进程修改环境变量,不会反向修改父进程的环境。

示例:

export APP_ENV=development

python app.py

Python 进程可以读取 APP_ENV。

如果 Python 程序内部修改环境变量,通常不会改变启动它的 Shell 环境。

flowchart TD
    A["Shell 进程"] --> B["设置 APP_ENV=development"]
    B --> C["启动子进程"]
    C --> D["子进程继承环境变量"]
    D --> E["读取环境变量"]
    E --> F["修改子进程环境"]
    F --> G["子进程环境发生变化"]
    G --> H["父进程环境保持不变"]

    style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style B fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style C fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style D fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style E fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style F fill:#FFF5DE,stroke:#E8D29A,color:#334155
    style G fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style H fill:#E8EDF2,stroke:#B8C3CE,color:#334155
    linkStyle default stroke:#A3B8AC,stroke-width:1.5px

需要注意,进程继承环境变量的具体实现与操作系统有关。

在 Windows 中,进程也有自己的环境块(Environment Block),子进程可以在创建时获得相应的环境配置。

4. 环境变量的作用范围

环境变量可以根据设置方式具有不同的作用范围。

设置方式 作用范围 示例
命令前临时赋值 通常仅影响本次命令及其子进程 APP_ENV=prod app
Shell 普通变量 当前 Shell APP_ENV=prod
Shell 导出变量 当前 Shell 及后续启动的子进程 export APP_ENV=prod
用户级配置 用户登录或启动的相关会话 Shell 配置文件
系统级配置 系统服务或相关进程 系统环境配置
容器环境配置 容器内进程 Docker ENV
CI/CD 配置 流水线任务或 Job CI Variables

并不是所有设置都能自动影响已经运行的进程。

大多数情况下,进程启动后拥有自己的环境变量集合。修改 Shell 配置文件或系统配置,不会自动刷新现有进程的环境。


三、环境变量的常见类型

环境变量可以按照用途进行分类。

1. 系统环境变量

系统环境变量通常用于配置操作系统和命令行工具。

常见变量:

变量 作用 常见系统
PATH 命令搜索路径 Linux、macOS、Windows
HOME 用户主目录 Linux、macOS
USER 当前用户名 常见 Unix 系统
SHELL 用户默认 Shell 常见 Unix 系统
LANG 默认语言和区域设置 Linux、macOS
TMPDIR 临时目录 Unix 系统
TEMP 临时文件目录 Windows 等
SystemRoot Windows 系统目录 Windows
USERPROFILE Windows 用户配置文件目录 Windows

不同操作系统的变量名称和语义并不完全相同。

2. PATH 环境变量

PATH 是最常见、最重要的环境变量之一。

它用于指定系统搜索可执行程序的目录。

例如:

echo "$PATH"

可能输出:

/usr/local/bin:/usr/bin:/bin

当用户执行:

python

Shell 通常会按照 PATH 中的目录顺序搜索对应的可执行文件。

如果某个目录中存在多个同名程序,通常会优先找到搜索顺序靠前的那个。

例如:

export PATH="/opt/python/bin:$PATH"

这会将 /opt/python/bin 放在原有搜索路径之前。

检查命令位置:

which python

在更强调可靠性的脚本中,也可以使用:

command -v python

Windows 中的 PATH 使用分号分隔路径,而 Unix 类系统通常使用冒号。

3. 应用程序环境变量

应用程序可以定义自己的环境变量。

例如:

APP_ENV
APP_PORT
APP_DEBUG
APP_LOG_LEVEL
APP_CONFIG_PATH

这些变量通常用于控制:

  • 应用运行模式。
  • 服务监听端口。
  • 日志输出级别。
  • 功能开关。
  • 配置文件路径。
  • 外部服务地址。

应用程序应明确规定变量名称、数据类型、默认值和校验规则,避免配置含义不清晰。

4. 敏感信息环境变量

一些环境变量可能用于传递敏感信息:

DATABASE_PASSWORD
API_TOKEN
JWT_SECRET
PRIVATE_KEY

虽然环境变量经常被用来传递密钥,但它并不是专门的密钥管理系统。

环境变量可能出现在:

  • 进程信息或调试信息中。
  • 崩溃转储中。
  • 诊断日志中。
  • CI/CD 日志中。
  • 容器配置和管理接口中。
  • 错误输出中。

因此,不应将环境变量视为天然安全的存储方式。

生产环境中应优先使用专门的密钥管理服务、受控的 Secret 注入机制或操作系统提供的安全凭据管理能力。


四、如何设置与读取环境变量?

不同操作系统和编程语言提供了不同的环境变量管理方式。

1. Linux / macOS

查看变量:

echo "$APP_ENV"

设置当前 Shell 变量:

APP_ENV=development

导出环境变量:

export APP_ENV=production

删除环境变量:

unset APP_ENV

为单次命令设置变量:

APP_ENV=test python app.py

这种写法通常只影响当前命令及其子进程,不会永久修改 Shell 配置。

2. Windows CMD

查看变量:

echo %APP_ENV%

设置当前命令行会话变量:

set APP_ENV=production

删除变量:

set APP_ENV=

设置只对当前 CMD 会话有效,关闭窗口后通常不会保留。

3. Windows PowerShell

读取:

$env:APP_ENV

设置:

$env:APP_ENV = "production"

删除:

Remove-Item Env:APP_ENV

设置只影响当前 PowerShell 进程及其后续启动的子进程,不等于永久修改系统环境变量。

4. Python 读取环境变量

Python 可以使用 os.environ 访问环境变量。

import os

app_env = os.environ.get(
    "APP_ENV",
    "development"
)

port = int(
    os.environ.get("PORT", "8000")
)

print(app_env)
print(port)

其中:

  • os.environ:访问进程环境变量。
  • get():读取变量并支持默认值。
  • int():将字符串转换为整数。

设置环境变量:

import os

os.environ["APP_ENV"] = "production"

这里修改的是当前 Python 进程的环境变量集合,不会自动修改父进程环境。

5. Java 读取环境变量

Java 可以通过 System.getenv() 读取环境变量。

public class Main {
    public static void main(String[] args) {
        String appEnv =
            System.getenv("APP_ENV");

        String port =
            System.getenv("PORT");

        System.out.println(appEnv);
        System.out.println(port);
    }
}

读取单个变量:

String value = System.getenv("APP_ENV");

获取全部环境变量:

Map<String, String> env =
    System.getenv();

Java 标准 API 提供读取环境变量的能力,但没有提供通过 System.getenv() 修改当前进程环境变量的标准接口。

6. JavaScript / Node.js 读取环境变量

Node.js 使用 process.env 访问环境变量。

const appEnv =
  process.env.APP_ENV || "development";

const port =
  Number(process.env.PORT || 3000);

console.log(appEnv);
console.log(port);

设置变量:

process.env.APP_ENV = "production";

这里修改的是当前 Node.js 进程中的环境变量对象,不会反向修改父进程的环境。

还需要注意,process.env 中的环境变量值通常以字符串形式处理,应用程序应自行进行类型转换和校验。

7. Go 读取环境变量

Go 使用 os.Getenv() 和 os.LookupEnv()。

package main

import (
    "fmt"
    "os"
)

func main() {
    appEnv := os.Getenv("APP_ENV")

    port, exists := os.LookupEnv("PORT")

    fmt.Println(appEnv)
    fmt.Println(port, exists)
}

两种方法的区别:

  • os.Getenv():变量不存在时返回空字符串。
  • os.LookupEnv():额外返回变量是否存在。

这一区别对于判断变量是否显式配置非常重要。

8. Rust 读取环境变量

Rust 标准库提供 std::env 模块。

use std::env;

fn main() {
    let app_env = env::var("APP_ENV")
        .unwrap_or_else(|_| {
            "development".to_string()
        });

    println!("{}", app_env);
}

读取结果可能包含错误,例如变量不存在或变量值无法转换为有效的 Unicode 字符串。

生产代码应根据具体业务决定如何处理这些错误。


五、运行环境的组成结构

运行环境不仅包含操作系统,还包括程序执行时所依赖的整个软件和资源体系。

1. 操作系统环境

操作系统为程序提供基础运行能力。

主要包括:

  • 进程管理。
  • 线程调度。
  • 内存管理。
  • 文件系统。
  • 网络通信。
  • 权限控制。
  • 系统调用接口。

例如,Linux、Windows 和 macOS 都可以运行 Java 程序,但它们的文件路径、进程管理、系统调用和动态链接机制存在差异。

2. 编程语言运行时

不同语言通常需要不同的运行时支持。

语言 常见运行环境 主要职责
Java JVM 字节码执行、内存管理、垃圾回收
Python CPython 等实现 解释执行、对象管理、模块加载
JavaScript V8、SpiderMonkey 等 JavaScript 执行、优化编译、垃圾回收
.NET CLR IL 执行、JIT、垃圾回收
Go Go Runtime 调度、内存管理、垃圾回收
Rust 原生可执行程序及标准库 提供语言库和运行支持

需要注意,语言运行时并不一定是独立的虚拟机进程。

例如,Go 程序通常将 Go Runtime 相关代码链接进生成的可执行程序中;Java 程序则通常运行在 JVM 之上。

3. 系统依赖与动态链接库

程序可能依赖操作系统提供的动态库。

例如:

  • Linux 中的 .so 文件。
  • Windows 中的 .dll 文件。
  • macOS 中的 .dylib 文件。

如果程序依赖的动态库不存在,可能出现加载失败。

Linux 中可以使用:

ldd ./app

查看动态依赖。

对于不可信的二进制文件,直接使用 ldd 需要注意安全风险。静态检查 ELF 动态依赖时,可以考虑:

readelf -d ./app

4. 外部服务环境

现代应用通常依赖其他服务:

  • MySQL、PostgreSQL 等数据库。
  • Redis 等缓存系统。
  • Kafka、RabbitMQ 等消息队列。
  • 对象存储服务。
  • 第三方 API。
  • 身份认证服务。

这些服务可能位于本机、局域网、云平台或其他容器中。

因此,应用运行环境不仅是本地软件环境,也包含外部服务的可访问性、网络连通性和认证配置。

5. 运行环境的层次结构

flowchart TD
    A["应用程序"] --> B["语言运行时"]
    B --> C["系统库与运行时依赖"]
    C --> D["操作系统"]
    D --> E["硬件与虚拟化资源"]
    A --> F["应用配置"]
    F --> G["环境变量"]
    F --> H["配置文件"]
    A --> I["外部服务"]
    I --> J["数据库"]
    I --> K["缓存与消息队列"]
    I --> L["第三方 API"]

    style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style B fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style C fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style D fill:#E8EDF2,stroke:#B8C3CE,color:#334155
    style E fill:#FFF5DE,stroke:#E8D29A,color:#334155
    style F fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style G fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style H fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style I fill:#FFF5DE,stroke:#E8D29A,color:#334155
    style J fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style K fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style L fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    linkStyle default stroke:#A3B8AC,stroke-width:1.5px

六、开发环境、测试环境与生产环境

软件项目通常不会只使用一个运行环境,而是根据软件开发和交付流程划分多个环境。

1. 开发环境(Development)

开发环境主要用于日常编码和调试。

典型特点:

  • 允许频繁修改代码。
  • 使用本地数据库或开发数据库。
  • 启用详细日志。
  • 支持调试工具。
  • 可能启用热重载。
  • 配置通常较为宽松。

例如:

APP_ENV=development
DEBUG=true
LOG_LEVEL=debug

开发环境的重点是提高开发效率。

2. 测试环境(Testing)

测试环境用于验证程序行为和质量。

常见类型:

  • 单元测试环境。
  • 集成测试环境。
  • 自动化测试环境。
  • 性能测试环境。
  • 验收测试环境。

典型配置:

APP_ENV=test
DEBUG=false
LOG_LEVEL=info

测试环境应尽可能接近生产环境,但通常会使用独立的测试数据和外部服务。

3. 预发布环境(Staging)

预发布环境用于模拟生产环境,验证上线前的部署过程和系统行为。

通常会尽可能保持以下配置与生产环境一致:

  • 操作系统。
  • 运行时版本。
  • 部署方式。
  • 网络结构。
  • 服务依赖。
  • 应用配置结构。

预发布环境不一定拥有与生产环境完全相同的资源规模,但应尽可能减少关键环境差异。

4. 生产环境(Production)

生产环境是实际承载用户请求的运行环境。

主要关注:

  • 系统稳定性。
  • 安全性。
  • 性能。
  • 可用性。
  • 监控与告警。
  • 日志与审计。
  • 数据备份。
  • 故障恢复。

典型配置:

APP_ENV=production
DEBUG=false
LOG_LEVEL=warn

生产环境应避免输出敏感信息,并限制调试接口和不必要的管理权限。

5. 多环境配置对比

对比维度 开发环境 测试环境 预发布环境 生产环境
主要目的 编码与调试 验证功能 上线前验证 对外提供服务
日志级别 debug info/debug info info/warn
调试功能 通常开启 按需开启 通常关闭 关闭
数据 开发数据 测试数据 脱敏或模拟数据 真实业务数据
外部服务 本地或开发服务 测试服务 预发布服务 生产服务
安全要求 基础 较高 高 最高

6. 多环境配置切换流程

flowchart TD
    A["应用启动"] --> B["读取 APP_ENV"]
    B --> C{"识别运行环境"}
    C -->|"development"| D["加载开发配置"]
    C -->|"test"| E["加载测试配置"]
    C -->|"staging"| F["加载预发布配置"]
    C -->|"production"| G["加载生产配置"]
    C -->|"未知"| H["使用安全默认策略或启动失败"]
    D --> I["合并配置"]
    E --> I
    F --> I
    G --> I
    I --> J["校验必需配置"]
    J --> K{"配置是否合法"}
    K -->|"是"| L["初始化应用"]
    K -->|"否"| M["输出配置错误并终止启动"]

    style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style B fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style C fill:#FFF5DE,stroke:#E8D29A,color:#334155
    style D fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style E fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style F fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style G fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style H fill:#FBE9E9,stroke:#D9AAAA,color:#334155
    style I fill:#E8EDF2,stroke:#B8C3CE,color:#334155
    style J fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style K fill:#FFF5DE,stroke:#E8D29A,color:#334155
    style L fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style M fill:#FBE9E9,stroke:#D9AAAA,color:#334155
    linkStyle default stroke:#A3B8AC,stroke-width:1.5px

七、配置文件与环境变量的关系

环境变量并不是唯一的应用配置来源。

实际项目中,通常还会使用配置文件、命令行参数、配置中心和密钥管理服务。

1. 常见配置来源

配置来源 示例 适用场景
默认配置 程序内置默认值 基础参数
配置文件 application.yml 结构化配置
环境变量 DATABASE_HOST 部署环境注入
命令行参数 --port=8080 临时覆盖
配置中心 Nacos、Consul 等 动态集中管理
密钥管理服务 Vault、云 Secret 服务 敏感配置

不同配置来源各有特点。

环境变量适合部署时注入简单配置,但当配置数量巨大、需要动态更新或需要复杂权限管理时,通常需要结合配置中心或专门的密钥管理服务。

2. 配置优先级

应用可以定义多个配置来源的优先级。

例如:

命令行参数
    >
环境变量
    >
外部配置文件
    >
默认配置

这种优先级是一种常见设计,并不是所有框架都采用完全相同的规则。

以 Spring Boot 为例,它拥有自己的外部化配置机制,并定义了较完整的属性来源优先级。

3. 配置加载流程

flowchart TD
    A["应用启动"] --> B["加载默认配置"]
    B --> C["读取配置文件"]
    C --> D["读取环境变量"]
    D --> E["解析命令行参数"]
    E --> F["合并配置来源"]
    F --> G["执行类型转换"]
    G --> H["执行配置校验"]
    H --> I{"配置是否合法"}
    I -->|"是"| J["生成最终配置对象"]
    I -->|"否"| K["报告配置错误"]
    J --> L["初始化业务模块"]

    style A fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style B fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style C fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style D fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    style E fill:#FFF5DE,stroke:#E8D29A,color:#334155
    style F fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style G fill:#E8EDF2,stroke:#B8C3CE,color:#334155
    style H fill:#F3EDFC,stroke:#C4B2E3,color:#334155
    style I fill:#FFF5DE,stroke:#E8D29A,color:#334155
    style J fill:#E5F4EC,stroke:#A3CBB5,color:#334155
    style K fill:#FBE9E9,stroke:#D9AAAA,color:#334155
    style L fill:#E0F0FE,stroke:#93BCE8,color:#1E4976
    linkStyle default stroke:#A3B8AC,stroke-width:1.5px

4. 配置类型转换

环境变量通常以字符串形式提供,但应用需要使用不同的数据类型。

例如:

PORT=8080
DEBUG=false
TIMEOUT=30

应用需要转换为:

PORT    → Integer
DEBUG   → Boolean
TIMEOUT → Integer

需要注意,布尔值不能简单地使用所有语言的默认类型转换规则。

例如 Python 中:

bool("false")

结果是 True,因为非空字符串会被视为真值。

因此应显式解析:

def parse_bool(value: str) -> bool:
    normalized = value.strip().lower()

    if normalized in ("true", "1", "yes", "on"):
        return True

    if normalized in ("false", "0", "no", "off"):
        return False

    raise ValueError(
        f"Invalid boolean value: {value}"
    )

5. 配置校验

配置读取后,不能直接假设所有值都正确。

例如:

import os

port = int(os.getenv("PORT", "8000"))

if not 1 <= port <= 65535:
    raise ValueError("Invalid port")

实际项目还应该校验:

  • 必需变量是否存在。
  • 数据类型是否合法。
  • 数值是否处于有效范围。
  • URL 格式是否正确。
  • 文件路径是否存在。
  • 数据库连接参数是否完整。
  • 敏感配置是否符合安全要求。

八、环境变量与 Docker 容器

容器技术让应用运行环境更加标准化,但容器并不意味着环境变量可以自动共享或同步。

Docker 可以在创建容器时注入环境变量。

1. Dockerfile 中设置环境变量

FROM python:3.12-slim

WORKDIR /app

COPY requirements.txt .

RUN pip install --no-cache-dir -r requirements.txt

COPY . .

ENV APP_ENV=production
ENV PORT=8000

CMD ["python", "app.py"]

ENV 指令用于设置镜像中的环境变量。

容器启动后,容器内的进程可以读取这些变量。

需要注意:不应该将数据库密码、API Token 等敏感信息直接写入 Dockerfile,因为这些值可能保留在镜像元数据或构建历史中。

2. docker run 注入环境变量

docker run \
  -e APP_ENV=production \
  -e PORT=8000 \
  my-app

也可以使用环境变量文件:

docker run \
  --env-file .env \
  my-app

示例 .env:

APP_ENV=production
PORT=8000
LOG_LEVEL=info

.env 文件通常是应用或容器工具约定的配置文件,并不是操作系统自动识别的环境变量文件。