如何让Electron Builder覆盖GitHub Release中已存在的文件？

阿华AIGC实验室

2026-5-12

解决Electron Builder上传GitHub Releases不覆盖文件的问题

首先直接说结论：Electron Builder本身并没有内置的配置选项来强制覆盖GitHub Releases中已存在的文件——它的默认行为是跳过已存在文件，避免误操作正式发布版本。不过针对你这种「每次构建成功后更新草稿发布，保持最新稳定版」的需求，有几个实用的解决方案：

方案1：用GitHub CLI先删除旧草稿再重新发布

这是最直接的思路：在Electron Builder发布前，先删掉GitHub上已有的同名草稿发布，让新构建产物能完全替换旧内容。具体操作步骤：

先在Travis的环境变量中配置GH_TOKEN（需要拥有仓库的repo权限，可在GitHub的个人令牌页面生成）

在Travis构建脚本里，添加删除旧草稿的命令：

# 替换成你实际的草稿发布名称和仓库地址
gh release delete latest-stable --yes --repo your-username/your-repo

接着运行Electron Builder的发布命令（确保package.json的build.publish里已设置draft: true）：
```
electron-builder build --publish always
```

方案2：自定义Node脚本调用GitHub API强制覆盖文件

如果不想删除整个草稿，只想覆盖其中的特定文件，可以用GitHub官方的Node.js库@octokit/rest写个自定义脚本，利用API的force参数强制覆盖：

先安装依赖：npm install @octokit/rest --save-dev

编写upload-release.js脚本：

const { Octokit } = require("@octokit/rest");
const fs = require("fs");
const path = require("path");

const octokit = new Octokit({ auth: process.env.GH_TOKEN });

async function uploadAssets() {
  // 先获取目标草稿发布的ID（假设草稿名称为latest-stable）
  const releases = await octokit.rest.repos.listReleases({
    owner: "your-username",
    repo: "your-repo"
  });
  let draftRelease = releases.data.find(r => r.name === "latest-stable" && r.draft);

  // 如果没有草稿，先创建一个
  if (!draftRelease) {
    const newRelease = await octokit.rest.repos.createRelease({
      owner: "your-username",
      repo: "your-repo",
      tag_name: "latest",
      name: "latest-stable",
      draft: true
    });
    draftRelease = newRelease.data;
  }

  // 遍历dist目录下的产物，上传并强制覆盖
  const distDir = path.join(__dirname, "dist");
  const files = fs.readdirSync(distDir);
  
  for (const file of files) {
    const filePath = path.join(distDir, file);
    const fileContent = fs.readFileSync(filePath);
    
    await octokit.rest.repos.uploadReleaseAsset({
      owner: "your-username",
      repo: "your-repo",
      release_id: draftRelease.id,
      name: file,
      data: fileContent,
      headers: { "Content-Type": "application/octet-stream" },
      force: true // 关键参数：强制覆盖已存在文件
    });
  }
}

uploadAssets().catch(console.error);

在Travis构建脚本里，打包完成后运行这个脚本即可：
```
electron-builder build
node upload-release.js
```

方案3：用Travis原生的GitHub Releases部署

如果不想依赖Electron Builder的发布功能，可以直接用Travis的deploy阶段完成部署，它支持overwrite参数强制覆盖文件：
在.travis.yml中添加如下配置：

deploy:
  provider: releases
  api_key: $GH_TOKEN
  file_glob: true
  file: dist/**/* # 替换成Electron Builder生成的产物路径
  skip_cleanup: true
  overwrite: true # 开启覆盖模式
  draft: true # 设置为草稿发布
  name: latest-stable # 草稿发布的名称
  on:
    branch: master # 只在master分支构建成功后触发

这样Travis会自动在构建完成后上传产物到GitHub Releases，并且覆盖已存在的文件。