# 实时写入与原子发布 .jsw 文件只追加:一个进程写入时,另一个进程可以同时读取,而不会读到半个块。在 SDK 中,文件只在 fechar() 时完整出现。 2026年11月13日 · jsonW 1.3.11 · https://jsonw.org/zh/newsroom/live-writing ## 问题 在另一个程序写文件时去读它,可能读到被截断的一行。程序在写到一半时崩溃,还可能留下一个写了一半的文件,覆盖原本完好的那个。 ## jsonW 的做法 .jsw 的每个块都能独立存在,带有标记、CRC32C 和哈希。因此格式允许在另一个进程写入时以流的方式读取,就像一个永远不会看到半个块的 tail -f。通过 SDK 写入时,文件只在 fechar() 时发布;出错退出时调用 abandonar(),目标文件保持原样。 ``` const { Escritor } = require("@wortictecnologia/jsonw"); const e = new Escritor("eventos.jsw", "id:i64,tipo:dic,quando:tempo"); e.gravar({ id: 1, tipo: "entrada", quando: "2026-11-13T09:00:00Z" }); e.fechar(); ``` 使用 Node SDK(npm @wortictecnologia/jsonw)写入。eventos.jsw 文件只在 fechar() 时才完整出现。 ## 在哪里 10 个 SDK 都支持原子发布。写入过程中的读取存在于核心中,但在 1.3.11 版本里,它在 wjsw 中没有命令,在公开 ABI 中也没有函数。 在论文中阅读完整章节: https://jsonw.org/zh/paper#ciclo