12.3 路径管理：用户目录、应用数据目录、临时目录规范

在 Electron 应用里读写本地文件是常见需求——保存用户配置、缓存数据、导出日志，都需要一个正确的存放位置。直接在项目目录或任意路径写入文件是大忌：安装目录可能没有写权限，更新时也可能被覆盖。Electron 提供了一套标准路径获取方法，帮你把数据放在操作系统认可的位置。

12.3.1 核心 API：`app.getPath(name)`

主进程中通过 app.getPath(name) 可以获取各种标准路径。name 是一个字符串，最常用的有：

| name | 用途 |
|------|------|
| 'userData' | 存放用户数据：配置、数据库、本地存储。这是最重要的一个路径。 |
| 'appData' | 当前用户的应用数据文件夹（各平台具体含义略有差异，多数情况下应优先使用 userData）。 |
| 'temp' | 系统临时文件夹，用于存放不必持久化的临时文件。 |
| 'home' | 当前用户的主目录。 |
| 'desktop' | 桌面文件夹。 |
| 'documents' | 用户的文档目录。 |
| 'downloads' | 下载目录。 |
| 'logs' | 应用日志文件夹。 |
| 'exe' | 可执行文件所在目录（开发环境通常指向 electron 二进制；打包后可用此获取安装根目录，但不应在这里写数据）。 |

调用示例：

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

const userDataPath = app.getPath('userData');
console.log(userDataPath);
// Windows: C:\Users\<用户名>\AppData\Roaming\<应用名>
// macOS:   /Users/<用户名>/Library/Application Support/<应用名>
// Linux:   /home/<用户名>/.config/<应用名>

12.3.2 不同平台的真实路径差异

你必须清楚这些路径在不同操作系统下的区别，因为有时需要直接查看或迁移用户数据。这里列出最常见的 userData 情况（假设你的应用名为 my-app）：

Windows：默认在 %APPDATA%/my-app 下，即 C:\Users\John\AppData\Roaming\my-app。如果希望数据跟着漫游账户同步，这正是合适的位置；如果数据不需要漫游，可以使用 'localAppData' 替代（通过 app.getPath 获取，对应 %LOCALAPPDATA%/my-app，不会参与漫游同步）。
macOS：~/Library/Application Support/my-app/。注意 Library 是隐藏文件夹，正常用户不会去翻看，这是持久化数据的标准位置。
Linux：遵循 XDG 规范，一般是 ~/.config/my-app/。

如果要在打包后修改默认的 userData 文件夹名称（即把 my-app 换成别的），可以在调用 app.getPath('userData') 前使用 app.setPath('userData', customPath) 显式覆盖，但必须在 app.whenReady() 之前调用，并且尽量不要改变惯例。

12.3.3 临时目录的正确用法

系统临时目录由 app.getPath('temp') 返回。这个目录里的文件随时可能被操作系统或用户清理，不适合存储任何长期数据。典型场景是：

下载大型文件时，先写入临时目录，下载完成并通过校验后再移动到最终位置。
导出报告时，生成一个临时 HTML/PDF，用系统默认程序打开，然后可以定期清理或让系统自行回收。
注意在应用退出时显式删除敏感临时文件，避免遗留数据的安全隐患。

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

const tempDir = app.getPath('temp');
const tempFile = path.join(tempDir, 'myapp_temp_export.pdf');
// 写入临时文件，后续清理由负责

12.3.4 日志与缓存目录的规范化

大多数应用需要记录日志，直接丢进 userData 里会让目录变得凌乱。Electron 提供了专用的 'logs' 路径：

const logsPath = app.getPath('logs');
// Windows: %APPDATA%/my-app/logs
// macOS: ~/Library/Logs/my-app
// Linux: ~/.config/my-app/logs (部分发行版可能为 ~/.cache/my-app)

你应该为应用创建标准子目录结构，例如：

userData/
├── config.json          // 用户设置
├── database/            // SQLite 数据库
├── cache/               // 长期缓存（非临时）
└── crashDumps/          // 崩溃转储（Electron 会自动存放）

这样便于用户手动备份或清理。

12.3.5 在渲染进程中安全获取路径

出于安全考虑，不要直接向渲染进程暴露 app.getPath 的全部能力。推荐的做法是在预加载脚本中通过 contextBridge 暴露一个限定的方法（或直接使用 IPC 请求），比如：

// preload.js
const { contextBridge, ipcRenderer } = require('electron');
contextBridge.exposeInMainWorld('paths', {
  getUserData: () => ipcRenderer.invoke('get-user-data-path'),
  getTemp: () => ipcRenderer.invoke('get-temp-path'),
});

主进程中处理：

ipcMain.handle('get-user-data-path', () => app.getPath('userData'));
ipcMain.handle('get-temp-path', () => app.getPath('temp'));

这样渲染进程只能在受控范围内获取路径，而无法任意读取或修改系统敏感目录。

12.3.6 开发环境与生产环境的区别

在开发阶段，app.getPath('userData') 返回的路径通常包含 Electron 字样（例如 macOS 下 ~/Library/Application Support/Electron），而不是你的应用名。这是正常现象。只有打包后的可执行文件运行时，userData 才会基于 package.json 中的 name 字段自动生成。如果你想在开发阶段也使用自定义名称，可以通过 app.setPath('userData', path.join(app.getPath('appData'), 'my-app-dev')) 强制指定，避免污染正式用户数据。

12.3.7 一个实用的路径初始化模式

许多应用会在启动时集中初始化所有目录，确保它们存在，并加载配置：

const fs = require('fs-extra');
const path = require('path');

async function initAppPaths() {
  const userData = app.getPath('userData');
  const dirs = ['database', 'cache', 'exports', 'logs'].map(d => path.join(userData, d));
  for (const dir of dirs) {
    await fs.ensureDir(dir);
  }
  // 还可在此加载或创建默认配置文件
}
app.whenReady().then(initAppPaths);

这种模式清晰且可靠，能让你的应用从一开始就在正确的轨道上运行。

总的指导原则：数据存 userData，临时放 temp，日志进 logs，其他目录仅作只读访问。遵循这条简单规则，你的应用在不同的操作系统上都能表现得像一个地道的桌面程序。