Firebase项目中Angular与Cloud Functions共享TypeScript接口方案

我来给你几个经过实践验证的解决方案，完美适配你的场景——既不需要在Cloud Functions后端引入完整的firebase包，又能让前后端共享包含GeoPoint的接口类型：

这个方法的核心是把跨端共享的类型定义抽离到单独的文件中，利用TypeScript的结构类型兼容性来适配前后端不同的GeoPoint实现：

1. 先在项目里创建一个共享类型文件，比如shared/types/geo-point.ts：

// 定义一个兼容前后端的GeoPoint类型
// 因为firebase和firebase-admin的GeoPoint结构完全一致（都包含latitude/longitude属性，以及toJSON方法）
export type CrossPlatformGeoPoint = {
  latitude: number;
  longitude: number;
  toJSON(): { _lat: number; _long: number };
};

2. 然后在共享接口里使用这个类型：

// shared/interfaces/school-address.ts
import { CrossPlatformGeoPoint } from '../types/geo-point';

export interface SchoolAddress {
  street: string;
  city: string;
  state: string;
  region: string;
  zip: string;
  note: string;
  position?: CrossPlatformGeoPoint;
}

这样不管是前端用firebase.firestore.GeoPoint实例，还是后端用admin.firestore.GeoPoint实例，都能完美匹配这个类型——TypeScript会因为结构兼容而允许赋值，完全不需要在后端引入firebase包。

如果想保留官方类型的完整方法定义（比如distance()等），可以在共享类型文件里通过环境推断动态选择对应的GeoPoint类型：

// shared/types/geo-point.ts
// 声明全局变量用于类型推断（Angular前端和Cloud Functions后端默认都满足）
declare global {
  var admin: typeof import('firebase-admin');
  var firebase: typeof import('firebase');
}

// 根据当前环境自动匹配对应的GeoPoint类型
export type CrossPlatformGeoPoint = 
  typeof firebase?.firestore.GeoPoint || 
  typeof admin?.firestore.GeoPoint;

然后在共享接口里导入这个类型即可。这个方案既能保留官方类型的所有特性，又不会引入多余的依赖代码。

如果你能接受后端安装firebase包但只导入类型，可以用TypeScript 3.8+支持的import type语法来避免引入实际代码：

// 后端文件中
import type { firestore } from 'firebase';

// 共享接口里直接使用firestore.GeoPoint

不过这个方案需要后端安装firebase依赖，虽然import type不会打包实际代码，但会增加依赖体积，所以不如前两个方案理想。

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