C#用JSON或二进制实现键值存储

推荐用 JSON Lines 格式存储键值对，每行一个带 key、value、timestamp 的对象，支持流式读写和增量更新；禁用 BinaryFormatter，改用 MessagePack 或自定义二进制格式；并发需细粒度锁+标记删除；key 需规范化编码并统一 UTF-8。

用 System.Text.Json 做轻量键值存储，别直接序列化整个字典

直接把 Dictionary 序列化成 JSON 写入文件看似简单，但实际会出问题：类型丢失（比如 DateTime 变成字符串）、嵌套结构难维护、并发写入时整个文件重写效率低。更稳妥的做法是把每个键值对单独序列化为一行 JSON（即 JSON Lines 格式），或用固定结构的包装类。

推荐结构：

{
  "key": "user_123",
  "value": { "name": "Alice", "score": 95 },
  "timestamp": "2024-06-15T10:22:33Z"
}

这样读取时可用 File.ReadLines() 流式解析，增删改只操作对应行（配合临时文件替换），避免加载全部数据到内存。

• 写入用 JsonSerializer.SerializeToUtf8Bytes() + FileStream.Write()，减少字符串分配
• 读取单个 key 时，用 yield return 遍历行，匹配后立即返回，不全加载
• 不要用 File.WriteAllText() 覆盖整个文件——这是性能和可靠性杀手

二进制方案选 BinaryFormatter？千万别

BinaryFormatter 已被微软标记为过时且不安全，反序列化任意二进制数据可能触发远程代码执行。即便你完全控制数据源，也应避开它。

替代方案有二：

• 用 System.Text.Json + MemoryStream + Span 手动拼接键长/值长/数据块，实现紧凑二进制格式（适合追求极致体积）
• 更实用的是 MessagePack（NuGet 包 MsgPack.CSharp）：序列化体积比 JSON 小 30–50%，保留类型信息，API 接近 JsonSerializer

例如存一个 (string key, byte[] value) 对：

var buffer = MessagePackSerializer.Serialize(new { k = key, v = value });

注意：MessagePack 默认不支持 DateTimeKind.Unspecified，需配置 MessagePackSerializerOptions.Standard.WithResolver(...) 显式处理。

并发写入时必须加锁，但别锁整个文件操作

多个线程同时写同一个 JSON Lines 文件，会导致内容错乱（如两行合并成一行）。不能靠 lock(obj) 包裹整个 File.AppendAllText() —— 这会让所有写请求排队，吞吐骤降。

• 用 FileStream 打开文件时指定 FileShare.Read，并设置 FileOptions.Asynchronous
• 写入前用 Monitor.TryEnter(_writeLock, timeoutMs) 控制临界区，超时则退避重试
• 删除 key 时，不物理删行，而写入一条 {"key":"xxx","deleted":true} 标记，读取时跳过——简化并发逻辑

如果真需要高并发，这个“文件数据库”就该让位给 LiteDB 或 SQLite —— 它们底层已做页级锁和 WAL 日志。

JSON 键名大小写和路径分隔符容易踩坑

Windows 文件系统不区分大小写，但 JSON key 是区分的："UserId" 和 "userid" 在解析后是两个不同键。若业务上认为它们等价，必须在存取前统一转小写或驼峰规则。

另一个常见问题：用路径当 key（如 "config/users/alice.json"）时，斜杠在 Windows 下可能引发 DirectoryNotFoundException（因为尝试创建子目录）。解决方案：

• key 中禁止出现 / \ : * ? " < > | 等非法字符，用 Uri.EscapeDataString() 编码
• 或直接用 SHA256 哈希代替原始路径，再存映射关系（额外占一点空间，但彻底规避路径问题）

最常被忽略的是 JSON 字符编码：确保始终用 UTF-8（无 BOM），否则某些旧工具读取时会把  当作 key 前缀。