Electron Forge 打包过程中的目录清理问题解析

问题现象

在使用 Electron Forge 7.5.0 进行应用打包时（npm run make），开发者遇到了一个常见的文件系统错误：ENOTEMPTY: directory not empty, rmdir。这个错误发生在 Windows 11 系统上，具体表现为 Electron Packager 尝试清理临时目录时失败。

问题本质

这个错误的核心在于文件系统操作冲突。当 Electron Forge 的打包过程尝试清理临时工作目录时，系统报告目录非空无法删除。这种情况通常由以下几种原因导致：

1. 文件锁定：某些文件可能被其他进程锁定，导致无法删除
2. 权限问题：当前用户对临时目录中的某些文件没有删除权限
3. 异步操作未完成：前一个打包过程的文件操作尚未完全结束
4. 防病毒软件干扰：安全软件可能正在扫描临时文件

技术背景

Electron Forge 的打包流程依赖 electron-packager 模块，后者会在系统临时目录（如 Windows 的 AppData\Local\Temp）中创建工作区。当多次运行打包命令时，如果前一次打包的清理过程不彻底，就会导致后续操作失败。

解决方案

1. 完全清理工作目录

在重新运行打包命令前，手动删除临时目录中的残留文件：

rm -rf %LOCALAPPDATA%\Temp\electron-packager\

2. 使用全新项目目录

在某些情况下，项目目录本身可能存在冲突。可以尝试：

mkdir new_project && cd new_project
npm init electron-app@latest

3. 调整打包配置

在 forge.config.js 中增加打包间隔时间，避免操作冲突：

module.exports = {
  packagerConfig: {
    tmpdir: false // 使用系统默认临时目录
  }
}

4. 关闭干扰进程

临时关闭防病毒软件或其他可能锁定文件的应用程序。

预防措施

1. 版本控制：保持 Electron Forge 和相关依赖为最新版本
2. 构建隔离：在 CI/CD 环境中使用独立的构建容器
3. 错误处理：在脚本中添加重试逻辑处理临时性错误
4. 日志记录：启用详细日志记录以定位具体失败点

深入分析

这个问题反映了 Windows 文件系统操作的一个常见挑战。与 Unix 系统不同，Windows 对文件锁定的处理更为严格，特别是在涉及防病毒软件扫描时。Electron 打包过程会产生大量小文件，这放大了文件锁竞争的可能性。

对于开发者而言，理解 Electron Forge 的工作流程很重要：

1. 准备阶段：收集所有应用资源
2. 打包阶段：使用 electron-packager 创建可分发包
3. 制作阶段：使用 maker 生成平台特定安装包
4. 清理阶段：删除临时工作文件

问题通常出现在第4阶段，因为前三个阶段产生的文件可能仍被系统或其他进程占用。

最佳实践建议

1. 对于持续集成环境，考虑在每个构建任务前强制清理工作区
2. 在开发环境中，避免同时运行多个打包进程
3. 对于复杂项目，可以考虑使用 Docker 容器提供隔离的构建环境
4. 定期清理系统临时目录，防止积累过多旧文件

通过理解这些底层机制和采取适当的预防措施，开发者可以有效避免这类打包过程中的文件系统错误。