tomevault-io 何时使用
- 编辑
packages/opencode中的文件 I/O 或扫描 - 处理目录操作或外部工具
Bun 文件 API（来自 Bun 文档）
Bun.file(path)是惰性的；调用text、json、stream、arrayBuffer、bytes、exists来读取。- 元数据：
file.size、file.type、file.name。 Bun.write(dest, input)写入字符串、缓冲区、Blobs、Responses 或文件。Bun.file(...).delete()删除文件。file.writer()返回 FileSink 用于增量写入。Bun.Glob+Array.fromAsync(glob.scan({ cwd, absolute, onlyFiles, dot }))用于扫描。- 使用
Bun.which查找二进制文件，然后使用Bun.spawn运行它。 Bun.readableStreamToText/Bytes/JSON用于流输出。
何时使用 node:fs
- 使用
node:fs/promises处理目录（mkdir、readdir、递归操作）。
代码库模式
- 优先使用 Bun API 而非 Node
fs进行文件访问。 - 读取前检查
Bun.file(...).exists()。 - 对于二进制/大文件使用
arrayBuffer()并通过file.type检查 MIME。 - 使用
Bun.Glob+Array.fromAsync进行扫描。 - 使用
Bun.readableStreamToText解码工具 stderr。 - 对于大写入，使用
Bun.write(Bun.file(path), text)。
快速检查清单
- 优先使用 Bun API。
- 使用
path.join/path.resolve处理路径。 - 尽可能优先使用 promise
.catch(...)而非try/catch。
Converted and distributed by TomeVault — claim your Tome and manage your conversions.