shell环境变量优先级最高，直接导出后参与${var}插值，覆盖.env文件和compose内默认值；推荐用~/.zshrc永久配置，临时调试可命令行前缀覆盖。

在 macos 上，shell 环境变量是 docker compose 项目配置的底层基础之一——它不依赖 .env 文件，而是直接作用于整个终端会话，优先级最高，适合全局控制或临时调试。

Shell 变量如何影响 Compose 行为

当你运行 docker compose up 时，Compose 会自动读取当前 Shell 中已导出（export）的变量，并用于插值替换 ${VAR}。比如你设置：

export APP_PORT=3000
export DB_PASSWORD=devpass123

那么在 docker-compose.yml 中写 "${APP_PORT}:3000" 或 DB_PASSWORD: "${DB_PASSWORD}" 就能实时生效。

注意：未用 export 声明的变量（如仅 APP_PORT=3000）不会被 Compose 读取。

永久配置 Shell 环境变量（推荐方式）

把变量写入 Shell 配置文件，让每次新开终端都自动加载：

• Apple Silicon（M1/M2/M3）默认使用 zsh → 编辑 ~/.zshrc
• 旧版 macOS 或自定义为 bash → 编辑 ~/.bash_profile

执行以下命令追加变量（以开发常用为例）：

WeChat macOS Proxy

macOS 微信消息自动化工具。通过 GUI 自动化实现：发送消息给指定联系人、读取聊天内容、监控新消息。适用于需要自动化微信操作的场景，如定时发送、批量回复、消息备份等。依赖 peekaboo 进行屏幕截图和 UI 交互。仅支持 macOS。开源地址：https://github.com/chairmanmia...

下载

echo 'export COMPOSE_PROJECT_NAME=myapp-dev' >> ~/.zshrc
echo 'export POSTGRES_VERSION=15' >> ~/.zshrc
echo 'export DEBUG=true' >> ~/.zshrc

然后重载配置：source ~/.zshrc。验证是否生效：echo $COMPOSE_PROJECT_NAME 应输出 myapp-dev。

临时覆盖与调试技巧

无需修改配置文件，就能快速验证不同参数组合：

• 单次运行覆盖：COMPOSE_PROJECT_NAME=test-env docker compose up -d
• 多变量组合：APP_ENV=staging DB_HOST=staging-db docker compose up
• 结合 --env-file 使用（Shell 变量仍优先）：export API_KEY=live-key; docker compose --env-file .env.local up

这种临时方式特别适合 CI 脚本、一键部署或排查环境差异问题。

和 .env 文件的协作关系

Shell 变量与 .env 文件不是互斥的，而是按明确优先级共存：

• Shell export 变量 > .env 文件中同名变量 > docker-compose.yml 中默认值
• 例如 .env 写 PORT=8080，但你在终端执行 export PORT=9000，则 Compose 总是取 9000
• 建议：Shell 中设通用/敏感/动态变量（如 COMPOSE_PROJECT_NAME、API_KEY），.env 存项目级静态配置（如数据库名、镜像版本）

这样既安全又清晰，避免密钥硬编码，也方便团队统一管理基础配置。