如何让Angular项目使用本地npm包时不加载firebase-admin依赖？

1. 拆分依赖与环境适配 #

• 将firebase-admin从dependencies移至peerDependencies，让Angular项目安装时不会强制拉取它，仅在Firebase Functions环境下手动安装：

  {
    "peerDependencies": {
      "firebase-admin": "^11.0.0",
      "@angular/fire": "^7.0.0"
    }
  }
  

• 在包的核心代码里用动态导入+环境判断加载firebase-admin，只在Node环境下初始化：

  import { AngularFirestore } from '@angular/fire/compat/firestore';
  
  // 定义跨端兼容的Firestore客户端类型
  type FirestoreClient = AngularFirestore | FirebaseFirestore.Firestore;
  
  export class FirestoreService {
    private client: FirestoreClient;
  
    constructor(clientOrConfig?: AngularFirestore | { admin: boolean }) {
      if (clientOrConfig instanceof AngularFirestore) {
        // Angular浏览器环境，直接使用@angular/fire实例
        this.client = clientOrConfig;
      } else if (clientOrConfig?.admin) {
        // Node环境（Firebase Functions），动态加载firebase-admin
        import('firebase-admin').then((admin) => {
          if (!admin.apps.length) {
            admin.initializeApp();
          }
          this.client = admin.firestore();
        });
      }
    }
  
    // 通用的Firestore读写方法实现...
  }
  

2. 配置Angular构建排除Node核心模块 #

• 修改Angular项目的angular.json，在build配置中添加自定义webpack配置项：

  {
    "projects": {
      "your-angular-app": {
        "architect": {
          "build": {
            "options": {
              "allowedCommonJsDependencies": ["@angular/fire"],
              "customWebpackConfig": {
                "path": "./webpack.config.js"
              }
            }
          }
        }
      }
    }
  }
  

• 新建项目根目录的webpack.config.js，通过externals跳过firebase-admin的打包：

  module.exports = {
    externals: {
      'firebase-admin': 'commonjs firebase-admin'
    }
  };
  

  这样Angular构建时会完全忽略firebase-admin相关依赖，避免触发Node核心模块缺失的报错。

3. 用类型文件隔离环境差异 #

• 在你的npm包中，创建types/browser.d.ts和types/node.d.ts，分别定义浏览器和Node环境下的专属类型；
• 修改包的tsconfig.json，默认加载浏览器端类型：

  {
    "files": [
      "./src/index.ts",
      "./types/browser.d.ts"
    ],
    "compilerOptions": {
      // 其他编译配置
    }
  }
  

  确保Angular项目引入包时，只会读取浏览器环境的类型定义，不会触发firebase-admin的类型依赖检查。

4. 双环境验证 #

• 在Firebase Functions环境下，手动安装firebase-admin并初始化你的包，测试Node端Firestore读写逻辑；
• 在Angular项目中安装包和@angular/fire，执行构建命令，确认无Node核心模块报错，浏览器端读写功能正常。

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