Node.js中fs.copyFile()与fs.copyFileSync()的区别是什么？

1. 执行模式：异步非阻塞 vs 同步阻塞 #

• fs.copyFile()是异步非阻塞方法：调用后立刻返回，文件复制操作在后台执行，不会卡住主线程。适合Web服务、批量任务这类需要同时处理其他逻辑的场景，不会影响程序的并发能力。
• fs.copyFileSync()是同步阻塞方法：调用后会一直等待文件复制完成，才会继续执行后续代码，期间主线程完全被占用。只适合脚本初始化、一次性文件拷贝这类不影响并发的场景。

2. 错误处理方式不同 #

• 异步的fs.copyFile()依赖回调函数处理错误，示例如下：

const fs = require('fs');
fs.copyFile("a.txt", "b.txt", (err) => {
  if (err) throw err;
  console.log("file is copied to the destination");
});

也可以用Promise化的版本结合async/await来捕获错误：

const { copyFile } = require('fs').promises;

async function copyFileExample() {
  try {
    await copyFile("a.txt", "b.txt");
    console.log("file is copied to the destination");
  } catch (err) {
    console.error('复制失败:', err);
  }
}

• 同步的fs.copyFileSync()必须用try/catch块捕获异常，出错时会直接抛出错误：

const fs = require('fs');
try {
  fs.copyFileSync("a.txt", "b.txt");
  console.log("file is copied to the destination");
} catch (err) {
  console.error('复制失败:', err);
}

3. 返回值差异 #

• fs.copyFile()没有有效返回值，复制结果只能通过回调或Promise的状态来判断。
• fs.copyFileSync()成功时返回undefined，失败则直接抛出异常，无返回值。

4. 对程序并发的影响 #

• fs.copyFile()不会阻塞Node.js的事件循环，在复制大文件时，程序依然能处理其他请求或任务，资源利用率更高。
• fs.copyFileSync()会阻塞事件循环，复制大文件期间，整个程序会暂停响应，严重影响高并发场景下的性能。

内容的提问来源于stack exchange，提问作者Nisal Jayathilaka