Cloud Functions与Cloud Run共享代码模块的解决方案咨询

1. 本地npm包引用（推荐） #

• 在根目录的公共模块（/lib、/methods）下执行npm init -y生成package.json，设置合适的包名（如project-common）
• 进入Cloud Functions目录，执行npm install ../（或指定公共模块的具体路径），将公共模块作为本地依赖添加到package.json
• 代码中直接通过包名引用：import { utilFunc } from 'project-common/lib/util'
• 部署时Firebase CLI会自动打包本地依赖，无需额外配置

2. 配置模块解析路径 #

• 在Cloud Functions目录下创建jsconfig.json（JS项目）或tsconfig.json（TS项目）：

  {
    "compilerOptions": {
      "baseUrl": ".",
      "paths": {
        "@lib/*": ["../lib/*"],
        "@methods/*": ["../methods/*"]
      }
    }
  }
  

• JS项目需额外安装module-alias包：npm install module-alias，并在Cloud Functions入口文件顶部添加：

  require('module-alias/register')
  

• 代码中可直接用别名引用：import { func } from '@lib/func'

3. 软链接共享 #

• 在Cloud Functions目录下创建指向外层公共模块的软链接：
  • Linux/macOS：cd functions && ln -s ../lib lib && ln -s ../methods methods
  • Windows：cd functions && mklink /D lib ../lib && mklink /D methods ../methods
• 代码中直接通过相对路径引用软链接后的目录：import { func } from './lib/func'
• 部署时Firebase CLI会跟随软链接复制文件，需提前测试打包是否正常

4. 独立私有npm包（长期维护方案） #

• 将/lib和/methods抽成独立项目，发布到私有npm仓库（如GitHub Packages、GitLab Packages）
• 在Cloud Functions和Cloud Run的项目中分别安装这个私有包：npm install @your-scope/project-common
• 后续公共模块更新只需发布新版本，两边项目更新依赖即可

内容的提问来源于stack exchange，提问作者Ibrahim.Sluma