这是Electron开发中非常常见的场景——开发时一切顺畅，打包后却出现文件系统相关的报错，核心原因大多和路径解析、asar打包机制或权限配置有关，我来一步步帮你定位解决：

1. 先获取精准的报错信息 #

首先别慌，先通过终端运行打包后的应用，拿到详细的错误日志，这能帮你快速定位问题：

# 进入build目录
cd /path/to/your/build/folder
# 运行应用的可执行文件
./MyApp.app/Contents/MacOS/MyApp

终端会输出具体的报错内容，比如是“找不到某个目录”还是“权限不足”，这是排查的关键。

2. 最常见的问题：路径解析错误 #

开发时，你可能用了相对路径（比如./data）或__dirname来指向要扫描的目录，但Electron打包后，应用的目录结构完全变了：

• 开发时__dirname指向你的项目源码目录
• 打包后__dirname指向asar归档文件内部的路径（如果开启了asar），或者Contents/Resources/app目录

解决方法：

• 改用Electron提供的API获取可靠的路径：

  const { app } = require('electron');
  const path = require('path');
  
  // 获取应用的根路径（打包后指向Contents/Resources/app或asar包）
  const appRoot = app.getAppPath();
  // 拼接你要扫描的目录路径
  const targetDir = path.join(appRoot, 'your-target-folder');
  

• 如果你的目标目录是项目中的静态资源（比如data/），需要确保electron-builder把它打包进去，在package.json的build配置里添加：

  "build": {
    "files": [
      "dist/**/*", // 你的编译产物目录
      "data/**/*"  // 要包含的静态资源目录
    ]
  }
  

3. Asar打包导致的访问限制 #

Electron-builder默认会把代码打包成asar归档文件（类似zip），但fs.scandir这类文件系统操作对asar内部的目录支持有限，尤其是涉及原生模块的场景。

解决方法：

方案A：将需要扫描的目录排除在asar之外 #

在package.json的build配置里用asarUnpack把目标目录提取到asar外部：

"build": {
  "asar": true,
  "asarUnpack": [
    "./your-target-folder/**/*" // 要提取的目录
  ]
}

提取后的目录会放在Contents/Resources/app.asar.unpacked/下，此时路径需要调整为：

const path = require('path');
// process.resourcesPath指向Contents/Resources目录
const targetDir = path.join(process.resourcesPath, 'app.asar.unpacked', 'your-target-folder');

方案B：临时禁用asar打包（用于测试） #

如果不确定是不是asar的问题，可以先关闭asar打包验证：

"build": {
  "asar": false
}

如果打包后运行正常，说明就是asar的问题，再用方案A针对性处理。

4. macOS权限配置问题 #

如果你的应用需要扫描用户目录（比如Documents、Downloads）或系统目录，macOS的沙箱机制会限制访问，导致scandir报错。

解决方法：

1. 创建一个entitlements.plist文件，添加权限声明：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <!-- 允许读取用户选择的文件/目录 -->
  <key>com.apple.security.files.user-selected.read-only</key>
  <true/>
  <!-- 如果需要读写权限，添加下面这行 -->
  <key>com.apple.security.files.user-selected.read-write</key>
  <true/>
</dict>
</plist>

2. 在package.json的build配置里关联这个文件：

"build": {
  "mac": {
    "entitlements": "./entitlements.plist",
    "entitlementsInherit": "./entitlements.plist"
  }
}

5. 依赖模块未正确打包 #

如果scandir是某个第三方模块的功能，可能打包时该模块的原生部分没有被正确编译或包含。

解决方法：

• 删除node_modules和package-lock.json，重新安装依赖：

  rm -rf node_modules package-lock.json
  npm install
  

• 检查package.json的files字段，确保没有排除该模块的文件：

  "files": [
    "node_modules/your-scandir-module/**/*"
  ]
  

按照这个流程排查，90%以上的scandir打包报错都能解决。

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