• src {string|Buffer|URL} 要拷贝的源文件名。
    • dest {string|Buffer|URL} 拷贝操作的目标文件名。
    • mode {integer} 用于拷贝操作的修饰符。默认值: 0。
    • 返回: {Promise}

    异步地将 src 拷贝到 dest。 默认情况下，如果 dest 已经存在，则覆盖它。 Promise 将会在成功时解决，且不带参数。

    Node.js 不保证拷贝操作的原子性。 如果在打开目标文件用于写入后发生错误，则 Node.js 将尝试删除目标文件。

    mode 是一个可选的整数，指定拷贝操作的行为。 可以创建由两个或更多个值按位或组成的掩码（比如 fs.constants.COPYFILE_EXCL | fs.constants.COPYFILE_FICLONE）。

    • fs.constants.COPYFILE_EXCL - 如果 dest 已存在，则拷贝操作将失败。
    • fs.constants.COPYFILE_FICLONE - 拷贝操作将尝试创建写时拷贝（copy-on-write）链接。如果平台不支持写时拷贝，则使用后备的拷贝机制。
    • fs.constants.COPYFILE_FICLONE_FORCE - 拷贝操作将尝试创建写时拷贝链接。如果平台不支持写时拷贝，则拷贝操作将失败。
    1. const {
    2.   promises: fsPromises,
    3.   constants: {
    4.     COPYFILE_EXCL
    5.   }
    6. } = require('fs');
    8. // 默认情况下将创建或覆盖目标文件。
    9. fsPromises.copyFile('源文件.txt', '目标文件.txt')
    10.   .then(() => console.log('源文件已拷贝到目标文件'))
    11.   .catch(() => console.log('该文件无法拷贝'));
    13. // 通过使用 COPYFILE_EXCL，如果目标文件存在，则操作将失败。
    14. fsPromises.copyFile('源文件.txt', '目标文件.txt', COPYFILE_EXCL)
    15.   .then(() => console.log('源文件已拷贝到目标文件'))
    16.   .catch(() => console.log('该文件无法拷贝'));