多目录结构下Firebase Functions构建：如何将API目录中的函数纳入最终构建

我明白你的痛点：现在Firebase Functions的源目录设为Extra，但想把API/src/index.ts里的触发器也打包进去，直接用相对路径导入却失败了。这大概率是因为Firebase的构建系统默认只处理源目录内的文件，外部目录的文件会被排除在构建上下文之外，或者TypeScript配置没覆盖到外部路径。

下面给你几个可行的解决方案，按推荐程度排序：

1. 重构目录结构（长期最优解） #

如果项目架构允许，建议把所有函数相关代码统一放到同一个源目录下，比如调整成这样的结构：

your-project/
  functions/
    src/
      api/          # 原API目录的所有内容
      extra/        # 原Extra目录的所有内容
      index.ts      # 在这里统一导出所有函数
  firebase.json

然后修改firebase.json里的Functions配置：

{
  "functions": {
    "source": "functions",
    "main": "functions/lib/index.js"
  }
}

这样完全符合Firebase Functions的最佳实践，后续维护也更省心，不会再出现跨目录导入的问题。

2. 调整Firebase构建上下文（无需改目录） #

如果不想动目录结构，可以修改firebase.json，把Functions的构建上下文从Extra改成项目根目录，同时指定构建后的入口文件：

{
  "functions": {
    "source": ".",  // 构建上下文改为项目根目录
    "main": "Extra/lib/index.js"  // 指向Extra目录构建后的入口
  }
}

这样Firebase CLI会把整个项目目录都纳入构建范围，../API/src/index的相对路径就能被正确解析了。

另外，如果你用的是TypeScript，记得把Extra/tsconfig.json的include数组加上API目录的路径，确保TS编译器能处理外部文件：

{
  "include": [
    "src/**/*",
    "../API/**/*"  // 添加这一行，覆盖API目录的所有文件
  ]
}

3. 本地用符号链接（临时调试方案） #

如果只是本地开发测试，可以在Extra目录下创建一个指向API目录的符号链接：

# macOS/Linux
cd Extra
ln -s ../API api

# Windows（管理员权限）
cd Extra
mklink /D api ../API

然后把导入路径改成相对符号链接的路径：

exports.graphql = require("./api/src/index");

不过要注意：部署到Firebase时，符号链接可能不会被正确识别，所以这个方法只适合本地调试，不推荐用于生产部署。

最后提醒下，不管用哪个方案，都先本地运行firebase functions:build测试构建是否成功，确认没有报错再部署。

内容的提问来源于stack exchange，提问作者Christo S. Christov