如何确保electron-builder构建Portable应用时文件哈希一致？

哈希不一致的常见原因 #

• 构建时间戳嵌入：Electron-Builder默认会将构建时间戳、环境信息写入可执行文件元数据或打包产物中，哪怕代码资源无变化，每次构建的时间戳不同都会直接改变文件哈希。
• 临时文件与随机化处理：构建过程中，代码压缩、SourceMap生成等插件可能引入随机标识符、临时文件名或随机种子，比如Terser混淆时的随机变量名、SourceMap的随机命名，这些细微差异会影响最终哈希。
• Portable包的动态元数据：指定portable目标时，Electron-Builder可能额外写入打包会话相关的动态信息（如临时路径、会话ID），这类内容随每次构建变化，进而改变哈希。

实现哈希一致的解决方案 #

• 固定构建时间戳与禁用动态构建信息
  在electron-builder.yml中添加配置，禁用自动生成的构建信息并设置固定时间戳：

  buildInfo: false
  timestamp: 1600000000000 # 替换为任意固定的时间戳数值
  

  这会阻止Electron-Builder写入动态的构建时间和环境数据，用固定值替代。

• 清理构建缓存并禁用缓存
  每次构建前手动清理dist、build等产物目录，或在构建命令中添加--no-cache参数禁用Electron-Builder缓存：

  electron-builder --no-cache
  

  避免缓存的临时文件或中间产物干扰最终构建结果。

• 固定插件的随机化行为
  若使用代码压缩工具（如Terser），在Vite配置中设置固定随机种子：

  // vite.config.js
  export default {
    build: {
      minify: 'terser',
      terserOptions: {
        mangle: {
          seed: 'fixed-seed' // 固定种子避免变量名随机变化
        }
      }
    }
  }
  

  若无需调试，可关闭SourceMap生成减少随机因素：

  // vite.config.js
  export default {
    build: {
      sourcemap: false
    }
  }
  

• 固定Portable包的产物配置
  在electron-builder.yml中明确指定Portable包的命名规则，避免动态文件名影响哈希：

  win:
    target:
      - portable
    portable:
      artifactName: "${productName}-${version}.${ext}"
  

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