JavaScript 中如何使用 async/await 进行文件 I/O 操作-js教程-PHP中文网

node.js 中 fs.promises api 配合 async/await 可实现简洁、可读性强的异步文件操作，支持 readfile、writefile、mkdir 等方法直接返回 promise，便于 try/catch 统一错误处理和顺序执行，但需注意路径兼容性、大文件流式处理等细节。

javascript 中如何使用 async/await 进行文件 i/o 操作

JavaScript 本身不直接支持文件 I/O，但在 Node.js 环境中可通过 fs.promises API 配合 async/await 实现简洁、可读性强的异步文件操作。

使用 fs.promises 替代回调或 Promise.then()

Node.js 从 v10 起内置 fs.promises 模块，所有文件方法（如 readFile、writeFile、mkdir）都返回 Promise，天然适配 await。

无需手动包装 fs.readFile 成 Promise，避免冗余代码
比 .then().catch() 更直观，错误可用 try/catch 统一处理
示例：读取 JSON 文件并解析

import { readFile } from 'fs/promises';

async function loadConfig() {
  try {
    const data = await readFile('./config.json', 'utf8');
    return JSON.parse(data);
  } catch (err) {
    console.error('读取配置失败:', err.message);
    throw err;
  }
}

顺序执行多个文件操作

当需要按顺序读、写、重命名或创建目录时，await 让流程线性清晰，避免“回调地狱”或嵌套 Promise 链。

OpenJDK 24

下载

每个 await 会等待前一步完成再执行下一步
适合日志写入、模板渲染后保存、配置生成等典型场景
注意：若操作可并行（如同时读多个文件），应改用 Promise.all()

import { readFile, writeFile, mkdir } from 'fs/promises';

async function generateReport() {
  const content = await readFile('input.txt', 'utf8');
  const result = content.toUpperCase();
  
  await mkdir('./output', { recursive: true });
  await writeFile('./output/report.txt', result);
}

处理常见文件操作类型

不同操作对应不同方法，全部支持 await，关键参数保持与传统 fs 一致。

读文件：readFile(path, options?) — 支持编码（如 'utf8'）或返回 Buffer
写文件：writeFile(path, data, options?) — 自动创建路径中不存在的目录需额外调用 mkdir(..., {recursive:true})
检查与删除：access(path) 判断权限或存在性；unlink(path) 删除文件；rmdir(path, {recursive:true}) 删除非空目录
读目录：readdir(path) 返回文件名数组，常配合 map + await 批量处理