未安装firebase包为何能在Cloud Functions中导入firebase/firestore？

在编写Firebase Cloud Functions的TypeScript代码时，为了定义接口，在文件顶部添加了导入语句：

import { Timestamp } from 'firebase/firestore';

项目并未直接安装firebase包，但该导入在TypeScript中无报错，可正常在接口中使用Timestamp类型。
项目package.json配置如下：

{
  "name": "functions",
  "scripts": {
    "lint": "eslint --ext .js,.ts .",
    "build": "tsc",
    "build:watch": "tsc --watch",
    "serve": "npm run build && firebase emulators:start --only functions",
    "shell": "npm run build && firebase functions:shell",
    "start": "npm run shell",
    "deploy": "firebase deploy --only functions",
    "logs": "firebase functions:log"
  },
  "engines": {
    "node": "16"
  },
  "main": "lib/index.js",
  "dependencies": {
    "@google-cloud/secret-manager": "^4.0.0",
    "axios": "^0.27.2",
    "firebase-admin": "^10.0.2",
    "firebase-functions": "^3.18.0",
    "googleapis": "^103.0.0"
  },
  "devDependencies": {
    "@typescript-eslint/eslint-plugin": "^5.12.0",
    "@typescript-eslint/parser": "^5.12.0",
    "eslint": "^8.9.0",
    "eslint-config-google": "^0.14.0",
    "eslint-config-prettier": "^8.5.0",
    "eslint-plugin-import": "^2.25.4",
    "firebase-functions-test": "^0.2.0",
    "typescript": "^4.5.4"
  },
  "private": true
}

补充的项目目录结构如下：

核心疑问：项目依赖中未安装firebase包，为何可以成功导入模块？是否是运行环境预装了相关依赖？

该现象和Cloud Functions运行环境预装依赖无关——类型校验通过不代表运行时导入可用，本质是TypeScript编译特性+Firebase依赖的类型声明共同导致的，具体原因：

• 类型擦除机制的影响：如果导入的Timestamp仅用在interface定义、类型注解场景，没有当作实际值调用（比如执行Timestamp.now()、实例化、作为参数传递），TypeScript编译为JS时会直接删除这条导入语句，不会在最终产物里保留对firebase/firestore的引用，编译阶段自然不会报模块不存在的错误。可以打开编译后lib/目录下的对应JS文件验证，里面根本找不到这行导入代码。
• 间接依赖的类型声明生效：安装的firebase-admin、firebase-functions都间接依赖了官方维护的@firebase/firestore-types类型包，这个包内置了Timestamp的完整类型结构。部分版本的Firebase SDK会通过TS的模块声明合并能力，隐式给firebase/firestore路径补充对应类型，TS做静态检查时能找到匹配的类型定义，就不会抛类型错误。
• 小概率是依赖提升导致：如果functions文件夹上一级（Firebase项目根目录）曾经装过firebase包，或者其他间接依赖把firebase包提升到了上层node_modules，TS递归向上查找模块时也能找到对应类型，但这种情况不影响最终结论：只要没在functions目录的package.json里显式声明firebase依赖，部署到Cloud Functions时不会安装这个包，一旦在运行时用到该导入的实际值，就会报模块找不到的错误。

正确用法 #

在Cloud Functions服务端代码里使用Timestamp不需要安装客户端firebase包，直接从服务端Admin SDK导入即可，类型和运行时都完全正常：

import { Timestamp } from 'firebase-admin/firestore';

如果确实需要使用客户端SDK的firebase/firestore模块，必须在functions目录下执行npm install firebase把它加到显式依赖里，否则部署后运行一定会报错。

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