Firestore 不支持直接对整个 Map 类型字段调用 FieldValue.increment()；但可通过点号（dot）语法将 Map 的每个键视为独立字段，分别执行原子递增更新。
firestore 不支持直接对整个 map 类型字段调用 `fieldvalue.increment()`；但可通过点号（dot）语法将 map 的每个键视为独立字段，分别执行原子递增更新。
在 Firestore 中，当你存储一个类似 { "0": 5, "1": 3, "2": 2, "3": 1, "4": 4 } 的对象到字段（例如 count）时，它并非一个单一的“Map 值”，而是五个独立的、可被单独索引与更新的字段：count.0、count.1、count.2、count.3 和 count.4。这是 Firestore 对嵌套对象（即 Map 类型）的底层建模方式，官方称之为「点号路径（dot notation）」。
因此，你无法像这样对整个 count 字段一次性使用 FieldValue.increment()：
// ❌ 错误：这会将整个 count 字段替换为一个新对象，而非原子递增
doc.ref.update({
count: {
"0": FieldValue.increment(5),
"1": FieldValue.increment(5),
// ... 其余同理
}
});
该写法实际触发的是字段级替换（set），而非原子操作，导致 FieldValue.increment() 在嵌套对象中失效。
✅ 正确做法是：显式列出每个带点号路径的子字段，并为每个路径单独指定 FieldValue.increment(delta)：
const delta = 5;
doc.ref.update({
"count.0": FieldValue.increment(delta),
"count.1": FieldValue.increment(delta),
"count.2": FieldValue.increment(delta),
"count.3": FieldValue.increment(delta),
"count.4": FieldValue.increment(delta),
});
执行后，原数据：
{ "0": 5, "1": 3, "2": 2, "3": 1, "4": 4 }
将原子化地更新为：
{ "0": 10, "1": 8, "2": 7, "3": 6, "4": 9 }
⚠️ 注意事项：
-
仅适用于 Map（对象），不适用于数组：
count.0可用，但若count是数组（如[5,3,2,1,4]），则count.0无法用于increment—— Firestore 数组元素不可通过点号路径单独更新。 -
键名需合法：点号路径中的键名应避免包含
.、$等特殊字符；若必须使用，建议改用FieldPath构造（但通常不推荐复杂嵌套）。 -
批量更新有数量限制：单次
update()最多支持 500 个字段更新，动态生成大量count.X路径时需注意此上限。 - 事务更安全（高并发场景）：若需条件判断或跨字段协调（如“仅当总和 runTransaction() 配合读-改-写逻辑。
总结：Firestore 的原子递增能力作用于字段粒度，而非数据结构粒度。要递增嵌套 Map 中的多个值，本质是并发更新多个带路径的独立字段——理解点号语法与字段模型，是高效、安全操作嵌套数据的关键。
