Firestore query函数首参传CollectionRef是否为不同函数签名？

两种用法对应的是同一个带有多重重载签名的query函数，不存在两个独立定义的query方法，你观察到的参数类型差异，是Firestore模块化SDK的类型继承设计+重载友好性设计共同导致的。

• 先理清楚核心的类型关系：在Firestore v9+ 模块化SDK中，CollectionReference 本身就是 Query 类的子类。你通过collection()方法拿到的集合引用，本质上就是一个「不带任何过滤、排序规则，默认查询集合内全量文档」的特殊Query实例，天然符合query函数对第一个参数的底层类型要求。
• SDK为query设计了多重重载签名，就是为了覆盖两类高频使用场景，不需要开发者做额外类型转换：
  1. 从零构建查询的场景：重载签名允许第一个参数直接传CollectionReference类型，后续传入任意数量的查询约束（包括where、orderBy、limit、startAt等），直接基于集合生成带条件的查询，也就是官方示例演示的用法：

  import { collection, query, where } from "firebase/firestore";
  const citiesRef = collection(db, "cities");
  // 直接传入集合引用生成查询
  const q = query(citiesRef, where("state", "==", "CA"));
  

  2. 链式追加查询条件的场景：重载签名允许第一个参数传入已经构建好的普通Query实例，后续传入新的查询约束，在原有查询的基础上追加规则生成新的查询，也就是文档里伪语法query(query, queryConstraints)描述的用法：

  // 在之前加州城市查询的基础上，追加人口大于100万的过滤条件
  const bigCitiesInCA = query(q, where("population", ">", 1000000));
  

• 有个细节需要注意：无论你传入的是集合引用还是已经存在的查询实例，query函数都不会修改你传入的原始对象，每次调用都会返回一个全新的不可变Query实例，不用担心原有查询被意外改动。

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