如何用electron-builder换应用图标？更换后无法更新求解决

看起来你在使用旧版本 electron-builder 时遇到了图标更新不生效的坑，我来帮你一步步排查解决：

一、先确认图标配置与文件的正确性 #

首先看你的 package.json 配置，win.icon 字段指向 ./build/icon.ico，这里要先确保两个关键点：

• 路径正确：这个相对路径是相对于你的 package.json 所在目录的，确认 build 文件夹下确实存在 icon.ico 文件，没有拼写错误（Windows 系统虽然不区分大小写，但构建工具可能严格校验）。
• 图标格式合规：Windows 应用图标需要包含多尺寸规格（至少要有 256x256 像素的版本），如果你的图标只有单尺寸，electron-builder 可能无法正确识别，最终 fallback 到默认图标。建议用专门的图标工具（比如 IconWorkshop）生成符合规范的 ICO 文件。

另外你配置里的 IconUrl 是用于 Squirrel 更新时的通知图标，和桌面应用图标无关，不用纠结这个字段的设置，重点还是 icon 字段。

二、清理构建缓存（最常见的问题） #

旧版本的 electron-builder 会缓存构建资源，哪怕你换了图标，它可能还在复用旧的缓存文件。你需要手动清理这些缓存：

• 删除项目根目录下的 dist 文件夹（这是构建产物存放目录）
• 删除 node_modules/.cache/electron-builder 目录（如果存在的话）
• 确保 build 文件夹里除了你的 icon.ico 之外，没有其他临时生成的图标文件

三、执行正确的构建命令 #

针对你的 electron-builder v5.7.0，直接运行以下命令即可触发完整构建：

# 如果全局没装 electron-builder，调用本地包的命令
node_modules/.bin/electron-builder

或者你可以在 package.json 的 scripts 里添加快捷命令：

"scripts": {
  "build": "electron-builder"
}

然后运行：

npm run build

四、最后一步：卸载旧版本再安装 #

如果你之前已经安装过这个应用，Windows 的 Squirrel 安装器可能会保留旧图标的系统缓存，导致新安装后还是显示默认图标。所以一定要先彻底卸载旧版本的应用，再安装你新构建的安装包。

额外排查技巧 #

如果还是不生效，你可以用 debug 模式运行构建，查看日志里有没有关于图标的报错信息：

electron-builder --debug

如果日志里出现「找不到图标文件」「图标格式错误」这类提示，就对应去修正路径或重新生成合规的图标文件。

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