Node.js 中 fs.rmdirSync 报 ENOTEMPTY 错误是因为它仅支持删除空目录，若目录含文件、子目录或隐藏文件（如 .gitkeep、.DS_Store）即失败；需先用 fs.readdirSync 和 fs.statSync 递归判断并清空内容，再确认真正为空后调用 rmdirSync。
不能直接用 VSCode 内置功能批量删空文件夹——它没提供“查找并删除所有空目录”的命令，必须靠 Node.js 脚本或终端命令实现。
为什么 fs.rmdirSync 会报 ENOTEMPTY 错误
Node 的 fs.rmdirSync 默认只删空目录，遇到含子目录或文件的路径就抛错。很多人写脚本时直接调用它，结果遍历到非空文件夹就中断，根本删不下去。
真正要删空文件夹，得先确认它真为空：既无文件、也无子目录（包括隐藏文件如 .git、.DS_Store），再调用 rmdirSync；否则跳过或报错。
- Windows 下注意
readdirSync可能返回.和..，但现代 Node 版本已过滤，无需手动排除 - macOS/Linux 隐藏文件（如
.git）会被readdirSync列出，必须检查——否则你以为是空文件夹，其实不是 - 权限不足时
statSync会抛EACCES，需 try/catch 包裹，否则整个脚本崩掉
用 fs.readdirSync + fs.statSync 判断并删空文件夹
核心逻辑是：递归遍历目标路径下所有子目录，对每个目录执行「读取内容 → 检查是否全为目录项且数量为 0」，满足才删。不递归删内容，只清理真正空的层级。
- 示例脚本片段：
function deleteEmptyFolders(dirPath) {
try {
const entries = fs.readdirSync(dirPath);
// 如果目录里啥都没有，直接删
if (entries.length === 0) {
fs.rmdirSync(dirPath);
console.log('Deleted empty folder:', dirPath);
return;
}
// 否则递归检查每个子项
for (const entry of entries) {
const fullPath = path.join(dirPath, entry);
try {
const stat = fs.statSync(fullPath);
if (stat.isDirectory()) {
deleteEmptyFolders(fullPath); // 先清内层
// 清完再查一遍当前目录是否变空
if (fs.readdirSync(dirPath).length === 0) {
fs.rmdirSync(dirPath);
console.log('Deleted now-empty folder:', dirPath);
}
}
} catch (e) {
// 权限问题或符号链接断裂，跳过不中断
}
}
} catch (e) {
// 路径不存在、无权限等，忽略
}
}
- 该函数不会删
node_modules或.git目录——它们显然不空，自然被跳过 - 慎用于
~/或C:\根路径：可能误删系统级空目录（如某些安装器残留的temp子目录） - 建议加个白名单过滤，比如跳过名为
node_modules、.git、dist的目录名，避免逻辑误入
在 VSCode 终端里用 find（Linux/macOS）或 forfiles（Windows）更快
Node 脚本适合跨平台或需集成进插件，但纯清理任务，系统命令更稳、更快、更少依赖。
- macOS/Linux：
find /path/to/project -type d -empty -delete—— 注意-delete是 GNU find 扩展，macOS 自带 find 不支持，得装brew install findutils用gfind - Windows CMD：
forfiles /p "C:\project" /s /d -0 /c "cmd /c if @isdir == TRUE rd /q @path 2>nul"不可靠，推荐 PowerShell：Get-ChildItem -Path "C:\project" -Recurse -Directory | Where-Object { (Get-ChildItem $_.FullName -Force | Measure-Object).Count -eq 0 } | ForEach-Object { Remove-Item $_.FullName -Force } - VSCode 终端里运行前，务必先
cd到目标项目根目录，避免路径错误删偏 - 所有命令都**不带 dry-run 模式**，执行即删，建议先加
-print（Linux/macOS）或Write-Host（PowerShell）预览将删哪些路径
容易被忽略的“空”陷阱：.gitkeep、.DS_Store、锁文件
你以为空的文件夹，很可能藏着一个 .gitkeep 或 macOS 的 .DS_Store——它们让 readdirSync 返回长度 > 0，导致判定为“非空”。这类文件体积小、易被忽略，却是批量删空操作失败的最常见原因。
- 判断“空”时，应过滤掉常见占位文件：
['.gitkeep', '.DS_Store', '.npmignore', 'README.md']等，只看剩余条目数 - VSCode 工作区里生成的
.vscode文件夹通常含settings.json，不算空——别指望它被删掉 - 某些构建工具（如 Vite、Next.js）会在输出目录放空
.gitignore，也会干扰判断，需结合业务场景定制过滤规则
真正安全的批量删空，从来不是“删所有看起来空的”，而是“删所有符合业务定义的空目录”——这个定义，得你亲手写进脚本里，VSCode 不会替你猜。
