electron-builder打包含Python-shell的应用后启动路径报错如何解决

electron-builder默认会把项目所有代码打包到asar只读归档中，相对路径在开发环境和打包后生产环境的解析逻辑完全不同，调用Python二进制/隐写脚本时用了固定相对路径，会导致打包后找不到对应资源。

• 优先将Python二进制、隐写脚本等可执行资源排除出asar归档，避免无法执行归档内文件的问题，在package.json的build配置中添加asarUnpack规则：

{
  "build": {
    "asar": true,
    "asarUnpack": [
      "**/python-bin/**",
      "**/steganography-scripts/**"
    ]
  }
}

自行替换规则中的目录为你项目中存放Python相关资源的目录，打包后这些资源会自动解压到app.asar.unpacked目录下。

• 统一使用Electron提供的官方API拼接资源路径，禁止直接使用./相对路径或者__dirname硬拼路径，适配开发/生产双环境的参考代码如下：

import { app } from 'electron'
import path from 'path'

const getResourcePath = (relativePath) => {
  const basePath = app.isPackaged 
    ? process.resourcesPath // 打包后资源根目录
    : path.join(__dirname, '../') // 开发环境根目录，根据你的项目结构自行调整
  return path.join(basePath, relativePath)
}

// 示例：获取Python二进制和脚本路径
const pythonBinPath = getResourcePath('app.asar.unpacked/python-bin/python')
const steganographyScriptPath = getResourcePath('app.asar.unpacked/scripts/steganography.py')

• 如果通过child_process调用Python进程，Windows平台下需要适配路径空格转义，添加shell参数避免执行失败：

import { spawn } from 'child_process'

const pyProcess = spawn(pythonBinPath, [steganographyScriptPath, yourParams], {
  shell: process.platform === 'win32'
})

• 额外添加extraResources配置，确保打包时Python相关资源被正确复制到生产环境的资源目录：

{
  "build": {
    "extraResources": [
      {
        "from": "src/python-bin",
        "to": "python-bin"
      },
      {
        "from": "src/steganography-scripts",
        "to": "scripts"
      }
    ]
  }
}

• 打包完成后可手动解压生成的安装包，打开resources目录确认Python二进制、脚本都存在，路径和代码中拼接的路径一致即可。

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