Electron自动更新配置报错：未设置GitHub Personal Access Token

这个问题我之前帮不少开发者排查过，大概率是环境变量传递或者配置细节出了问题，咱们一步步来定位解决：

1. 先排查环境变量的拼写与生效范围 #

• 首先注意到你提到设置了GT_TOKEN，这明显是拼写错误！正确的环境变量名应该是GH_TOKEN，先修正这个拼写问题。
• 确认环境变量是否在当前终端会话生效：
  • Windows终端执行：echo %GH_TOKEN%，macOS/Linux终端执行：echo $GH_TOKEN，看是否能正确输出你的GitHub Token。如果没有输出，说明变量没设置成功，重新设置：
    • Windows：set GH_TOKEN=你的GitHubToken
    • macOS/Linux：export GH_TOKEN=你的GitHubToken
  • 如果你是在IDE（比如VS Code）中运行打包命令，要检查IDE的集成终端是否继承了系统环境变量，或者直接在IDE的环境变量配置中添加GH_TOKEN（比如VS Code的settings.json或launch配置）。

2. 验证electron-builder.yml的配置正确性 #

• 确保配置文件放在项目根目录，并且格式正确，publish部分的配置应该是这样的：

  publish:
    provider: github
    token: ${GH_TOKEN}
  

• 可以先临时硬编码Token测试（不推荐用于生产，仅排查问题）：把${GH_TOKEN}换成你的实际Token，重新打包，如果不再报错，说明是变量替换的问题，回到环境变量的排查。
• 检查package.json中的build字段是否覆盖了electron-builder.yml的配置：如果package.json里有build.publish配置，它的优先级会高于yml文件，确保这里的token配置也是正确的。

3. 确认GitHub Token的权限 #

• 登录GitHub，进入你的Token管理页面，确保这个Token拥有足够的权限：
  • 如果是私有仓库，需要勾选repo权限；如果是公开仓库，勾选public_repo权限即可。
  • 不要给Token额外的权限，避免安全风险，但至少要具备发布Release和访问仓库的权限。

4. 检查打包脚本的环境变量传递 #

• 如果是通过npm script执行打包（比如npm run dist），可以先在脚本中添加变量打印，验证是否能获取到Token：

  // package.json
  "scripts": {
    "dist": "echo $GH_TOKEN && electron-builder"
  }
  

  执行脚本后看终端是否输出Token，如果没有，说明脚本执行时环境变量没传递过来，需要在执行脚本时直接注入变量：
  • Windows：set GH_TOKEN=你的Token&& npm run dist
  • macOS/Linux：GH_TOKEN=你的Token npm run dist

5. 其他排查点 #

• 清除electron-builder的缓存：删除项目根目录下的node_modules/.cache/electron-builder文件夹，重新打包，避免缓存导致的配置不生效。
• 检查electron-builder版本：对比你的演示项目和实际项目的electron-builder版本是否一致，不同版本的配置逻辑可能有差异，尽量保持版本统一。

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