Node.js批量操作文件夹异步时序异常 复制文件提前执行问题求解

• checkFolder 没有返回Promise：async函数如果没有显式return值，默认返回resolve(undefined)，你内部的异步IIFE执行结果根本没有被return，所以await checkFolder()会立刻完成，不会等删除、创建操作结束
• 同步API和async/await混用冗余：del.sync、makeDir.sync、fs.existsSync都是同步阻塞方法，不需要套async/await或者then回调，执行完就直接进入下一步
• 参数传递错误：循环里遍历的是a作为当前文件夹，却传了整个folders数组给checkFolder
• fs.copyFile是回调式API，没有封装成Promise，即使前面的操作等待正常，也不会等复制完成再进入下一轮循环

同步版本（适合小型构建脚本，逻辑简单不易出错） #

const fs = require('fs')
const del = require('del')
const makeDir = require('make-dir')

function checkFolderSync(folder) {
    if (fs.existsSync(folder)) {
        del.sync(folder, { force: true })
    }
    makeDir.sync(folder)
}

const startBuildSync = (folders, sourceFilePath, targetFileName) => {
    for (const folder of folders) {
        // 顺序执行删除、创建操作
        checkFolderSync(folder)
        // 执行文件复制
        try {
            fs.copyFileSync(sourceFilePath, `${folder}/${targetFileName}`)
            console.log(`${folder} 处理完成`)
        } catch (err) {
            console.error(`${folder} 复制文件失败:`, err)
        }
    }
}

// 调用示例
const folders = ['目标文件夹1', '目标文件夹2', '目标文件夹3']
const sourceFile = './template/file'
const targetFile = 'file'
startBuildSync(folders, sourceFile, targetFile)

异步版本（适合大文件/多文件夹场景，不阻塞事件循环） #

const fs = require('fs/promises') // 调用Node内置promise化的fs异步API
const del = require('del')
const makeDir = require('make-dir')

async function checkFolderAsync(folder) {
    try {
        // 检测文件夹是否存在
        await fs.access(folder)
        // 存在则强制删除
        await del(folder, { force: true })
    } catch {
        // 不存在则跳过删除步骤
    }
    // 创建新文件夹
    await makeDir(folder)
}

const startBuildAsync = async (folders, sourceFilePath, targetFileName) => {
    for (const folder of folders) {
        try {
            // 等待删除、创建操作全部完成
            await checkFolderAsync(folder)
            // 等待文件复制完成
            await fs.copyFile(sourceFilePath, `${folder}/${targetFileName}`)
            console.log(`${folder} 处理完成`)
        } catch (err) {
            console.error(`${folder} 处理失败:`, err)
        }
    }
}

// 调用示例
const folders = ['目标文件夹1', '目标文件夹2', '目标文件夹3']
const sourceFile = './template/file'
const targetFile = 'file'
startBuildAsync(folders, sourceFile, targetFile).then(() => {
    console.log('全部文件夹处理完成')
})

两种实现都严格保证「删除→创建→复制」的顺序执行，不会出现时序错乱问题。

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