Jetpack Datastore中“每个文件一个实例”限制的来源是什么？

• 核心结论：不管是在同一个文件里创建两个DataStore实例，还是在不同文件各创建一个指向同一磁盘文件的实例，本质都是生成了多个操作同一文件的DataStore实例，都会触发文档中提到的功能损坏问题，两者没有本质区别。

• 原因解释：DataStore是基于磁盘文件实现的本地存储组件，每个实例内部维护了独立的读写锁、状态跟踪机制。如果多个实例同时操作同一个文件，这些实例之间无法共享状态与锁，会引发并发读写冲突——轻则出现数据读取不一致，重则直接损坏存储的文件数据。

• 关于Kotlin全局变量的误区：Kotlin类外部的全局变量确实可以在同包不同文件间自由迁移而不影响普通逻辑，但DataStore的限制并非针对代码存放位置，而是针对磁盘文件对应的实例数量——只要是指向同一个文件的多个实例，不管代码写在哪，都违反了它的设计约束。

• 正确实践：必须确保针对每个DataStore文件，整个应用中只有唯一实例。通常可以用Kotlin的object单例实现，或者通过Hilt等依赖注入框架绑定为单例，避免意外创建多实例。

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