Backstage.io本地开发环境变量的正确传递方法

以下几种方法可以让你在本地开发时，无需维护硬编码配置，就能让app-config.yaml中的环境变量替换生效：

方法1：启动命令临时注入 #

启动Backstage时直接在命令前附带环境变量，适合临时测试或单次启动，无需修改任何配置文件：

• Linux/macOS 终端：

AUTH_GITLAB_CLIENT_ID=你的GitLab客户端ID AUTH_GITLAB_CLIENT_SECRET=你的GitLab客户端密钥 yarn dev

• Windows PowerShell：

$env:AUTH_GITLAB_CLIENT_ID="你的GitLab客户端ID"; $env:AUTH_GITLAB_CLIENT_SECRET="你的GitLab客户端密钥"; yarn dev

• Windows 命令提示符（CMD）：

set AUTH_GITLAB_CLIENT_ID=你的GitLab客户端ID && set AUTH_GITLAB_CLIENT_SECRET=你的GitLab客户端密钥 && yarn dev

方法2：用.env文件持久化变量 #

Backstage默认支持读取项目根目录下的.env或.env.local文件（.env.local默认被.gitignore忽略，不会提交到仓库），只需创建文件并写入变量，启动时自动加载：

1. 在项目根目录创建.env.local：

AUTH_GITLAB_CLIENT_ID=你的GitLab客户端ID
AUTH_GITLAB_CLIENT_SECRET=你的GitLab客户端密钥

2. 正常启动Backstage即可：

yarn dev

方法3：在app-config.local.yaml中复用环境变量替换 #

如果想通过app-config.local.yaml管理但不想硬编码值，可以直接在其中继续使用环境变量替换语法，Backstage会自动合并配置并解析变量：

# app-config.local.yaml
auth:
  providers:
    gitlab:
      development:
        clientId: ${AUTH_GITLAB_CLIENT_ID}
        clientSecret: ${AUTH_GITLAB_CLIENT_SECRET}

这种方式既保留了环境变量的灵活性，又利用了local配置的优先级特性。

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