Tencent/MMKV

这是什么？

核心功能

• 01基于 mmap 与 protobuf 存取数据，读写效率高。
• 02修改立即落盘，无需调用 sync 或 save。
• 03在支持的平台上支持多进程并发访问。
• 04二进制体积小，各平台每个架构约增加 7K 至 50K。
• 05覆盖 Android、iOS、macOS、Windows、POSIX 和 HarmonyOS NEXT。

适用场景

• 在 Android 或 iOS 应用中持久化配置和小型键值状态。
• 在同一应用的多个进程之间共享存储的数据。
• 为桌面或 POSIX 类程序添加轻量级本地存储。

快速上手

1. 1

   通过 Maven/Gradle 安装 Android 库

   implementation 'com.tencent:mmkv:2.4.3'
2. 2

   通过 CocoaPods 安装 iOS/macOS 库

   pod install
3. 3

   通过 OHPM 安装 HarmonyOS NEXT 库

   ohpm install @tencent/mmkv
4. 4

   克隆源代码以用于 Windows 或 POSIX 构建

   git clone https://github.com/Tencent/MMKV.git

使用前须知

• !官方仅支持 Android、iOS/macOS、Windows、POSIX 和 HarmonyOS NEXT；Kotlin Multiplatform 支持仍处于实验阶段。
• !从 v2.0.0 起不再支持 Android 的 32 位架构及 API 级别 21-22。
• !元数据中的许可证显示为 NOASSERTION，但 README 声明为 BSD 3-Clause。

收录于专题

标签

常见问题

MMKV 是什么？

一个高效、体积小的键值存储框架，源自微信，适用于移动端和桌面端应用。 MMKV 是一个用于移动端和桌面端应用的键值存储框架，最初用于微信应用。它通过 mmap 将内存与文件保持同步，并使用 protobuf 编解码数据，写入后即时生效，无需调用 sync、apply 或 save。

MMKV 可以免费使用吗？用的什么许可证？

MMKV 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

MMKV 还在维护吗？

活跃维护中。MMKV 最近一次提交是在 2026年11月4日。

MMKV 适合用来做什么？

在 Android 或 iOS 应用中持久化配置和小型键值状态。 在同一应用的多个进程之间共享存储的数据。 为桌面或 POSIX 类程序添加轻量级本地存储。

MMKV 怎么安装和运行？

通过 Maven/Gradle 安装 Android 库: implementation 'com.tencent:mmkv:2.4.3' 通过 CocoaPods 安装 iOS/macOS 库: pod install 通过 OHPM 安装 HarmonyOS NEXT 库: ohpm install @tencent/mmkv 克隆源代码以用于 Windows 或 POSIX 构建: git clone https://github.com/Tencent/MMKV.git

在哪里获取 MMKV？

源代码和安装说明在 GitHub 上：https://github.com/Tencent/MMKV