开发容器中用dotenv-vault与ZSH时Firebase认证失败排查

一、source .env后Firebase命令无法认证的问题 #

核心原因 #

source .env加载普通KEY=VALUE格式的变量时，这些变量属于Shell本地变量，不会被传递给Firebase这类子进程；而手动执行export是将变量设为环境变量，子进程能继承环境变量，因此可以正常完成认证。另外，dotenv-vault生成的.env文件可能未自动添加export前缀，导致变量无法成为环境变量。

解决建议 #

1. 修改.env文件添加export前缀
   将变量行调整为：

   export GOOGLE_APPLICATION_CREDENTIALS=/workspaces/project-name/GOOGLE_APPLICATION_CREDENTIALS.json
   

   重新source .env后，Firebase命令即可读取到环境变量。

2. 使用dotenv-vault官方加载方式
   dotenv-vault推荐用run命令包裹业务命令，自动注入环境变量，无需手动source：

   npx dotenv-vault run firebase <你的具体命令>
   

   这种方式能确保变量正确注入子进程，避免手动source的环境变量传递问题。

3. 临时批量export变量
   若不想修改.env文件，可通过sed命令自动给有效变量行添加export后再source：

   source <(sed '/^#/d;/^$/d;s/^/export /' .env)
   

   该命令会跳过注释和空行，只给实际变量行添加export前缀。

二、ZSH dotenv插件无法加载.env变量的问题 #

常见原因 #

1. 插件未正确启用
2. .env文件权限过于开放（ZSH dotenv插件为安全考虑，会拒绝加载权限大于600的文件）
3. 插件未开启自动加载配置
4. 当前终端未处于.env所在的项目根目录
5. 插件版本过旧

解决建议 #

1. 确认插件已启用
   检查~/.zshrc文件，确保plugins数组中包含dotenv：

   plugins=(... dotenv ...)
   

   保存后执行source ~/.zshrc重启Shell。

2. 修正.env文件权限
   执行命令将权限设为仅当前用户可读可写：

   chmod 600 .env
   

3. 开启自动加载配置
   在~/.zshrc中添加以下配置，强制插件自动加载.env：

   ZSH_DOTENV_AUTOLOAD=true
   

   部分dotenv插件版本默认关闭自动加载，需手动开启。

4. 切换到项目根目录
   确保当前终端处于.env所在的项目根目录，插件默认只加载当前目录的.env文件。

5. 升级插件
   若使用oh-my-zsh的dotenv插件，执行以下命令升级：

   cd ~/.oh-my-zsh/custom/plugins/dotenv
   git pull
   

   升级后重启Shell测试。

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