解决electron-vite项目GitHub Actions自动发布重复Release问题

在electron-vite项目中配置GitHub Actions自动发布时，开发者可能会遇到一个常见问题：构建过程中意外生成重复的Release版本。本文将深入分析问题原因并提供解决方案。

问题现象

当按照electron-vite文档配置.github/workflows/release.yml文件后，构建过程中会出现以下异常情况：

1. 每个操作系统构建任务中缺少必要的环境变量配置
2. npm run build:linux命令会自动发布Release草稿
3. 执行softprops/action-gh-release@v1后会产生两个Release版本

问题根源分析

经过排查，发现问题的根本原因在于electron-builder.yml配置文件中的publish参数设置不当。electron-builder工具在构建过程中会根据publish参数决定是否自动发布构建产物。

默认情况下，如果未明确配置publish参数，electron-builder可能会尝试自动发布构建结果到GitHub Release，这就与后续的softprops/action-gh-release操作产生了冲突，导致重复发布。

解决方案

要解决这个问题，我们需要修改electron-builder.yml配置文件的publish参数设置：

1. 将publish参数明确设置为默认值
2. 确保构建过程不会自动发布Release

正确的配置示例如下：

publish: null

或者完全移除publish参数，让electron-builder使用默认行为。

配置建议

为了确保GitHub Actions工作流正常运行，建议同时检查以下配置：

1. 在每个操作系统构建任务中添加必要的环境变量：

env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

2. 确保发布操作只由softprops/action-gh-release一个步骤完成

3. 在构建命令中明确禁用自动发布：

npm run build:linux -- --publish never

总结

通过合理配置electron-builder的publish参数，可以有效避免自动发布导致的重复Release问题。理解构建工具的工作机制对于配置自动化发布流程至关重要。electron-vite项目结合GitHub Actions可以实现高效的持续集成和发布流程，但需要特别注意各环节的配置细节以避免意外行为。