You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

关于Firestore文档自定义ID支持的特殊字符及空格的咨询

Firestore自定义文档ID字符规则详解

嘿,刚好对Firestore文档ID的规则比较熟,我来给你详细说清楚!

支持的字符

除了你已经知道的base62字符(a-z, A-Z, 0-9),大部分常见特殊字符都是支持的,比如你提到的_、&、$、@、!、`、~、%这些都可以放心用。

绝对不支持的字符

有几个字符是Firestore明确禁止的,一定要避开:

  • /(正斜杠):Firestore用斜杠来区分集合和文档的层级路径,用它会直接导致路径解析混乱
  • .(句号):属于系统预留的特殊符号,会和内部命名规则冲突
  • #(井号):是Firestore的保留字符,不能出现在文档ID里
  • [ 和 ](左右方括号):同样是保留字符,禁止使用
  • *(星号):作为通配符被Firestore预留,用来匹配路径,所以也不能用在文档ID中

关于空格的使用

完全没问题!像abc 123这种包含空格的自定义ID是合法的。不过要提醒你一句:后续在代码里引用这个文档的时候,要确保字符串正确包含空格,比如拼接文档路径时别不小心把空格弄丢了,或者在URL里传递的时候要正确编码,避免出现解析错误。

内容的提问来源于stack exchange,提问作者AbuMaaiz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.28 04:11:17