Node.js版本适配Firebase：如何降级至v6.11.5及多版本管理

Hey there, let's work through this Node.js version issue with Firebase together—super common problem, and easy to fix once you know the right tools!

先搞懂为什么会出问题 #

That warning pops up because back then, Google Cloud Functions only supported Node.js v6.11.5, but you're running v8.9.4 which is too new. This mismatch isn't just a warning—it's exactly why your blank new project won't run either. The local Firebase server needs to match the runtime environment that Cloud Functions uses to avoid compatibility bugs.

要不要只为Firebase项目用v6.11.5？ #

绝对要！你得让Firebase项目保持在v6.11.5（和Cloud Functions的运行环境对齐），但其他项目完全可以继续用最新版Node.js。不用全局降级，我们用版本管理工具就能把它们分开管理。

Node.js多版本管理的最佳工具：nvm #

nvm（Node Version Manager）是无缝切换Node.js版本的首选工具，Mac/Linux直接用，Windows用户可以用nvm-windows（兼容的独立工具）。步骤如下：

1. 安装nvm #

• Mac/Linux: 打开终端，执行nvm官方安装脚本，安装完成后重启终端，输入nvm --version确认安装成功。
• Windows: 下载nvm-windows安装程序，跟着向导完成安装，重启命令提示符或PowerShell，输入nvm version验证。

2. 安装Node.js v6.11.5 #

在终端/命令行里运行：

nvm install 6.11.5

等待安装完成，nvm会自动处理下载和配置工作。

3. 为Firebase项目单独指定版本 #

• 进入你的Firebase项目根目录，创建一个名为.nvmrc的文件（不要加扩展名），里面只写一行6.11.5。
• 之后每次进入这个项目目录，运行nvm use，nvm就会自动切换到v6.11.5；离开项目目录后，会自动回到你默认的Node.js版本。
• 如果你临时需要全局切换版本，运行nvm use <你的默认版本号>就行，比如nvm use 8.9.4。

验证版本并启动Firebase服务器 #

切换版本后，先确认版本是否正确：

node --version

应该显示v6.11.5。现在再运行firebase serve，警告会消失，你的空白新项目也能正常运行了！

额外避坑提示 #

• 如果安装v6.11.5时遇到下载慢的问题，可以切换国内镜像：
  • Mac/Linux: 在终端先运行export NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node，再执行安装命令。
  • Windows: 找到nvm-windows安装目录下的settings.txt，添加两行：

    node_mirror: https://npm.taobao.org/mirrors/node/
    npm_mirror: https://npm.taobao.org/mirrors/npm/
    

• 部署Firebase Functions时，务必在package.json里设置engines字段：

  "engines": {
    "node": "6"
  }
  

这样能保证云端运行环境用的是兼容版本。

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