Electron Forge项目中Vite构建时本地文件被自动删除问题解析

在Electron应用开发过程中，使用Electron Forge结合Vite构建工具时，开发者可能会遇到一个典型问题：应用程序启动时自动删除本地生成的文件。这种现象通常发生在开发阶段，特别是当文件被存储在Vite的构建目录中时。

问题现象

当开发者将数据文件（如JSON配置文件）保存在.vite/build/目录下时，这些文件会在应用程序重启时被自动清除。例如，一个用于保存关机计划配置的shutdownSchedules.json文件，虽然能够成功创建并写入数据，但在应用重新启动后就会消失。

根本原因

这个问题源于Vite构建工具的工作机制。在开发模式下，Vite会维护一个内存中的文件系统，并且每次启动时都会重新构建项目目录。.vite/build/目录实际上是Vite的临时构建输出目录，不应该用于持久化存储应用数据。

解决方案

1. 使用Electron提供的标准路径

Electron提供了app.getPath(name)API来获取适合存储持久化数据的标准目录：

const { app } = require('electron');
const path = require('path');

// 获取用户数据目录
const userDataPath = app.getPath('userData');
const shutdownSchedulesPath = path.join(userDataPath, 'shutdownSchedules.json');

userData目录是Electron应用存储配置和数据的推荐位置，不同操作系统下的具体路径为：

• Windows: %APPDATA%/[应用名]
• macOS: ~/Library/Application Support/[应用名]
• Linux: ~/.config/[应用名]

2. 使用Vite的public目录

如果确实需要在构建目录中包含文件，可以将其放在Vite的public目录中。这个目录下的文件会被直接复制到构建输出中而不会经过处理：

project-root/
  public/
    shutdownSchedules.json

然后在代码中通过相对路径引用：

const shutdownSchedulesPath = path.join(__dirname, '../public/shutdownSchedules.json');

最佳实践建议

1. 区分开发和生产环境：在开发阶段可以使用Vite的public目录，但在生产环境中应该使用Electron的标准数据目录。

2. 数据持久化策略：

   • 用户生成的数据：始终存储在userData目录
   • 应用默认配置：可以打包在应用中，首次运行时复制到userData目录
   • 临时文件：使用temp目录

3. 路径处理：始终使用path.join()来构建文件路径，确保跨平台兼容性。

4. 错误处理：对文件操作添加适当的错误处理，特别是在Electron应用中，文件系统权限可能受限。

通过遵循这些原则，可以避免开发过程中因构建工具行为导致的数据丢失问题，同时确保应用在不同环境下都能正确持久化数据。