Chokidar监听文件夹时重命名子文件夹、删除非空子文件夹等操作异常

环境信息 #

• Chokidar版本：3.5.2
• Angular CLI：12.0.2
• Node.js版本：16.17.0
• 包管理器：npm 9.2.0
• 操作系统：Windows 10

Chokidar默认配置 #

// Chokidar默认配置：
const defaultOptions = {
    ignored: /(^|[\/\\])\../, // 忽略隐藏文件
    persistent: true,
    depth: 99,
    alwaysStat: true,
    awaitWriteFinish: {
        stabilityThreshold: 2000,
        pollInterval: 100
    },
    ignorePermissionErrors: false,
    atomic: true // 或者自定义"原子性延迟"，单位毫秒（默认100）
}

问题复现步骤及现象 #

• 使用Chokidar监听任意文件夹（例如：Test 1）；
• 在Test 1内创建子文件夹Test 2；
• 尝试重命名Test 2时，Windows弹出提示："文件夹正在使用中"，提示内容为"操作无法完成，因为文件夹或其中的文件已在另一个应用程序中打开"；
• 若Test 2子文件夹非空，尝试删除时会弹出**"文件夹访问被拒绝"**，提示"需要提供管理员权限才能删除此文件夹"。

问题原因推测 #

该问题源于Chokidar在Windows系统下监听文件夹时，会占用文件夹句柄，导致系统无法对文件夹执行重命名、删除等操作。社区已有同类问题反馈：

• nota项目#149问题
• sync-directory项目#53问题
• Chokidar官方仓库#664问题

可行解决方案 #

1. 调整alwaysStat配置：将默认的alwaysStat: true改为false，让Chokidar仅在必要时获取文件/文件夹的stat信息，减少句柄占用。
2. 优化persistent配置：若业务不需要持续监听，可将persistent设为false，监听结束后自动释放资源（Angular场景下需结合业务判断是否适用）。
3. 缩短awaitWriteFinish阈值：将stabilityThreshold从默认2000毫秒适当缩短（如改为500毫秒），减少Chokidar对文件夹的锁定时长。
4. 通过ignored排除非必要监听项：将不需要监听的子文件夹加入ignored规则，减少不必要的句柄占用。

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