Electron打包.exe后data.json文件读写异常问题求助

核心问题原因 #

Electron打包为exe后，应用的安装目录（包含asar包）是只读的。如果你的代码用相对路径直接读写项目内的data.json，开发环境下（npm run start）可以正常操作本地文件，但打包后写入操作会被系统重定向到临时解压目录，而读取时仍指向asar包内的空文件，导致看似写入成功但读取为空的问题。

具体解决方案 #

1. 切换到用户专属可读写目录存储数据 #

使用Electron提供的app.getPath()方法获取用户专属的可读写路径，这是跨平台的标准做法：

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

// 获取用户数据目录（每个用户唯一，可读写）
const userDataDir = app.getPath('userData');
// 拼接data.json的完整路径
const dataFilePath = path.join(userDataDir, 'data.json');

可选的其他合法存储路径：

• documents: 用户文档目录
• desktop: 用户桌面目录
• downloads: 用户下载目录

2. 标准化读写操作逻辑 #

写入数据（异步方式，避免阻塞主线程）

async function saveUserInfo(userInfo) {
  try {
    // 确保目录存在（递归创建父目录）
    await fs.mkdir(path.dirname(dataFilePath), { recursive: true });
    // 格式化JSON写入，便于查看
    await fs.writeFile(dataFilePath, JSON.stringify(userInfo, null, 2));
    console.log('数据已写入:', dataFilePath);
  } catch (err) {
    console.error('写入失败:', err.message);
  }
}

读取数据

async function loadUserInfo() {
  try {
    // 先检查文件是否存在
    await fs.access(dataFilePath);
    const rawData = await fs.readFile(dataFilePath, 'utf8');
    return JSON.parse(rawData);
  } catch (err) {
    // 文件不存在时返回默认结构
    if (err.code === 'ENOENT') {
      return { users: [] };
    }
    console.error('读取失败:', err.message);
    return null;
  }
}

3. 规避常见路径错误 #

• 禁止直接使用__dirname或相对路径拼接文件路径：打包后__dirname指向asar包内的只读路径
• 统一开发/生产环境路径：app.getPath()返回的路径在两种环境下都有效，无需额外判断
• 打印路径验证：在代码中加入console.log(dataFilePath)，打包后查看日志，手动前往该路径确认文件是否真的被写入

4. 优化渲染进程的文件操作 #

建议不要在渲染进程直接读写文件，通过主进程的IPC通信处理：

// 主进程
const { ipcMain } = require('electron');
ipcMain.handle('save-user-info', async (_, userInfo) => {
  return await saveUserInfo(userInfo);
});

ipcMain.handle('load-user-info', async () => {
  return await loadUserInfo();
});

// 渲染进程
const { ipcRenderer } = require('electron');
// 注册时调用
await ipcRenderer.invoke('save-user-info', { username: 'xxx', avatar: 'xxx' });
// 读取时调用
const userData = await ipcRenderer.invoke('load-user-info');

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