> ## Documentation Index
> Fetch the complete documentation index at: https://bun.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 递增写入文件

Bun 提供了一个用于递增写入文件的 API。这对于写入大型文件，或长时间写入文件非常有用。

在 `BunFile` 上调用 `.writer()` 可以获取一个 `FileSink` 实例。该实例可用于高效地缓冲数据，并周期性地“刷新”到磁盘。你可以多次写入和刷新。

```ts theme={"theme":{"light":"github-light","dark":"dracula"}}
const file = Bun.file("/path/to/file.txt");
const writer = file.writer();

writer.write("lorem");
writer.write("ipsum");
writer.write("dolor");

writer.flush();

// 继续写入和刷新
```

***

`.write()` 方法可以接受字符串或二进制数据。

```ts theme={"theme":{"light":"github-light","dark":"dracula"}}
w.write("hello");
w.write(Buffer.from("there"));
w.write(new Uint8Array([0, 255, 128]));
writer.flush();
```

***

当内部缓冲区满时，`FileSink` 也会自动刷新。你可以通过 `highWaterMark` 选项配置缓冲区大小。

```ts theme={"theme":{"light":"github-light","dark":"dracula"}}
const file = Bun.file("/path/to/file.txt");
const writer = file.writer({ highWaterMark: 1024 * 1024 }); // 1MB
```

***

写入完成后，调用 `.end()` 来自动刷新缓冲区并关闭文件。

```ts theme={"theme":{"light":"github-light","dark":"dracula"}}
writer.end();
```

***

完整文档：[FileSink](/runtime/file-io#incremental-writing-with-filesink)。