# Node.js fs.writeFile 参考

URL: https://caijiao.org/reference/nodejs/fs-writefile
Source: docs/reference/nodejs/fs-writefile.md
Description: Node.js fs.writeFile Reference，整理常见语法、ESM 示例、CommonJS 差异、常见错误和相关 Node.js 生态链接。

Node.js fs.writeFile 是 Node.js 核心能力的一部分。ESM 中推荐使用 `node:` 前缀导入；CommonJS 中可使用 `require("node:fs")`。

## 语法

```text
fs.writeFile(file, data[, options])
```

## 最小示例

```js
import { writeFile } from 'node:fs/promises';
await writeFile('dist/result.json', JSON.stringify({ ok: true }, null, 2));
```

## 常见错误

- 混用 ESM 与 CommonJS，导致导入方式不一致。
- 忽略异步错误，未使用 try/catch 或错误事件处理。
- 把示例路径写死到特定系统，导致 Windows 和 Linux 表现不同。

## 相关内容

- [Express 教程](/express/)
- [Fastify 教程](/fastify/)
- [PM2 教程](/pm2/)
- [Docker Reference](/reference/docker/)