向Firebase预部署脚本传递环境变量时静默失败

这个问题的核心是Firebase CLI执行predeploy脚本时的Shell环境和你直接在命令行执行的环境不一致，导致环境变量设置命令没有生效，进而让后续的构建流程“看似执行但实际未正确触发”。

为什么会出现这个情况？ #

• 如果你是Windows系统下用CMD执行命令，set是正确的环境变量设置命令，但Firebase CLI运行predeploy脚本时，可能默认调用的是PowerShell或其他Shell，set命令的行为会出现差异；
• 如果你是在类Unix系统（macOS、Linux、WSL）下，set并不是设置环境变量的正确命令——类Unix系统需要用export，直接写set不会把变量传递给后续的npm run build进程；
• 另外，Firebase的predeploy脚本对命令串的解析逻辑和原生Shell有区别，即使你用了&&连接命令，环境变量也可能无法被后续的构建命令继承。

解决方法 #

方法1：针对不同系统使用对应命令

如果你明确知道自己的部署环境，可以针对性调整命令：

• Windows CMD环境：把命令拆分为数组中的两个独立步骤（Firebase支持predeploy数组多命令执行）：

  {
    "hosting": {
      "predeploy": [
        "set NUXT_ENV_GCLOUD_PROJECT=whatever",
        "npm run build"
      ]
    }
  }
  

  注：这种方式在部分Shell环境下可能依然不生效，因为每个命令会在独立子Shell中执行，环境变量无法跨子Shell继承。

• 类Unix/WSL环境：替换为export命令：

  {
    "hosting": {
      "predeploy": ["export NUXT_ENV_GCLOUD_PROJECT=whatever && npm run build"]
    }
  }
  

方法2：跨平台通用方案（推荐）

使用cross-env包统一跨平台的环境变量设置逻辑，不管Windows还是类Unix系统都能正常工作：

1. 先安装cross-env作为开发依赖：

   npm install --save-dev cross-env
   

2. 修改firebase.json的predeploy脚本：

   {
     "hosting": {
       "predeploy": ["cross-env NUXT_ENV_GCLOUD_PROJECT=whatever npm run build"]
     }
   }
   

   cross-env会自动识别当前系统，选择正确的环境变量设置方式，确保变量能被npm run build正确读取。

方法3：使用.env文件（备选）

如果你的环境变量较多，可以把NUXT_ENV_GCLOUD_PROJECT=whatever写入项目根目录的.env文件（Nuxt默认会自动加载根目录的.env文件），这样predeploy脚本只需要保留构建命令即可：

{
  "hosting": {
    "predeploy": ["npm run build"]
  }
}

注：要确保.env文件没有被加入.gitignore（如果需要随代码部署），或者在Firebase控制台的环境变量配置中同步该值（不过Nuxt的环境变量是构建时注入，本地.env更直接）。

验证方式 #

修改完成后，可以执行firebase deploy --only hosting --debug查看详细日志，确认环境变量是否被正确注入，以及npm run build是否真正触发了构建流程。

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