TypeScript部署Firebase云函数遇‘functions未被读取’警告求助

嘿，这绝对是Firebase云函数入门阶段超常见的小问题，完全不用慌！我刚入门的时候也踩过这个坑😅

警告的本质 #

这个警告是Firebase部署时自带的ESLint代码检查抛出的——它发现你导入了firebase-functions模块，但从头到尾没在代码里用过functions这个对象。简单说就是：你把工具领来了，却没让它干活～

常见原因&解决办法 #

• 你没把普通函数注册成Firebase云函数
  很多新手会犯这个错：写了一个普通的Node.js函数，但没通过functions模块的API把它注册成Firebase能识别的云函数。
  错误示例：

  // 只是定义了普通函数，Firebase根本不知道这是个云函数
  const helloWorld = (req, res) => {
    res.send("Hello World!");
  };
  

  正确示例：

  // 用functions.https.onRequest把函数注册成HTTP云函数
  import * as functions from 'firebase-functions';
  
  export const helloWorld = functions.https.onRequest((req, res) => {
    res.send("Hello World!");
  });
  

  只要你用functions对象的任意API（比如functions.firestore、functions.auth、functions.https）来定义你的云函数，这个警告就会自动消失。

• 你确实不需要functions模块
  如果你的代码真的不需要用到Firebase云函数的核心API（这种情况极少，毕竟你是在部署云函数），那直接删掉导入语句就行——省得ESLint瞎操心。

为啥本地运行正常？ #

本地测试的时候，你可能是直接调用了普通函数，或者用了其他测试工具，不需要Firebase的注册逻辑。但部署的时候，Firebase要求你必须通过它的functions模块来声明哪些是要部署的云函数，不然它不知道该把哪些代码上传到云端。

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