使用Electron Forge打包Electron应用时自定义图标不生效求助

针对你遇到的打包后.exe仍显示默认Electron图标的问题，可按以下步骤排查解决：

1. 修正图标路径配置 #

你的forge.config.json中packagerConfig.icon使用了绝对路径/assets/icons/proxyClicker，这会指向系统根目录而非项目目录，导致Electron Forge无法找到图标文件。需修改为相对路径：

packagerConfig: {
  asar: true,
  icon: './assets/icons/proxyClicker' // 去掉开头斜杠，使用项目根目录相对路径
}

2. 为Squirrel Maker单独配置图标 #

Windows下使用@electron-forge/maker-squirrel打包时，基础的packagerConfig.icon仅作用于主应用exe，安装程序（setup.exe）及生成的快捷方式图标需单独配置：

makers: [
  {
    name: '@electron-forge/maker-squirrel',
    config: {
      iconUrl: './assets/icons/proxyClicker.ico', // 快捷方式图标
      setupIcon: './assets/icons/proxyClicker.ico' // 安装程序自身图标
    },
  },
  // 其他maker配置...
]

3. 验证.ico文件有效性 #

Windows对图标文件有严格要求，需确保proxyClicker.ico满足：

• 包含多种尺寸（16x16、32x32、64x64、128x128、256x256）
• 采用32位真彩色带Alpha通道格式
• 无损坏或格式错误

可使用专业图标工具（如IconWorkshop）或在线转换工具重新生成符合规范的.ico文件。

4. 彻底清理缓存并重新打包 #

残留的缓存文件可能导致旧图标无法覆盖，需执行以下操作：

• 删除项目根目录下的out/文件夹
• 删除node_modules/.cache/electron-forge/缓存目录
• 重新执行打包命令：

  # Windows PowerShell
  Remove-Item -Recurse -Force out\
  Remove-Item -Recurse -Force node_modules\.cache\electron-forge\
  npm run make
  

5. 验证打包结果 #

• 先检查out/<app-name>-win32-x64/目录下的主exe图标是否正确
• 若使用Squirrel生成安装包，需完成安装后查看桌面、开始菜单的快捷方式图标是否正常

修改后的完整forge.config.json示例 #

const { FusesPlugin } = require('@electron-forge/plugin-fuses');
const { FuseV1Options, FuseVersion } = require('@electron/fuses');

module.exports = {
  packagerConfig: {
    asar: true,
    icon: './assets/icons/proxyClicker'
  },
  rebuildConfig: {},
  makers: [
    {
      name: '@electron-forge/maker-squirrel',
      config: {
        iconUrl: './assets/icons/proxyClicker.ico',
        setupIcon: './assets/icons/proxyClicker.ico'
      },
    },
    {
      name: '@electron-forge/maker-zip',
      platforms: ['darwin'],
    },
    {
      name: '@electron-forge/maker-deb',
      config: {},
    },
    {
      name: '@electron-forge/maker-rpm',
      config: {},
    },
  ],
  plugins: [
    {
      name: '@electron-forge/plugin-auto-unpack-natives',
      config: {},
    },
    new FusesPlugin({
      version: FuseVersion.V1,
      [FuseV1Options.RunAsNode]: false,
      [FuseV1Options.EnableCookieEncryption]: true,
      [FuseV1Options.EnableNodeOptionsEnvironmentVariable]: false,
      [FuseV1Options.EnableNodeCliInspectArguments]: false,
      [FuseV1Options.EnableEmbeddedAsarIntegrityValidation]: true,
      [FuseV1Options.OnlyLoadAppFromAsar]: true,
    }),
  ],
};

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