Electron Forge的GitHub发布器无法识别GITHUB_TOKEN环境变量

API 探路者

2026-6-25

解决Electron Forge发布GitHub包时GITHUB_TOKEN未加载的问题

问题描述

已在.env文件中配置正确的GITHUB_TOKEN，但使用Electron Forge向GitHub发布包时触发错误：Forge内部发生未处理的拒绝，提示Please set GITHUB_TOKEN in your environment to access these features。

配置代码：

{
  name: '@electron-forge/publisher-github',
  config: {
    repository: {
      owner: 'xxxxxx',
      name: 'xxxxxx'
    },
    prerelease: true,
    draft: true,
    authToken: process.env.GITHUB_TOKEN,
  }
}

.env文件内容：

GITHUB_TOKEN=xxxxxxxxxxx

解决方法

手动加载.env文件
Electron Forge不会自动读取.env文件，需安装dotenv包实现环境变量加载：
```
npm install dotenv --save-dev
```
在forge.config.js顶部添加加载代码：
```
require('dotenv').config();
```
确认.env文件位置
确保.env文件放在项目根目录（与package.json同级），否则dotenv无法定位到文件。
通过脚本执行发布（Windows环境适用）
Windows cmd/PowerShell不会自动加载.env变量，可在package.json中配置包含dotenv加载的发布脚本：
```
{
  "scripts": {
    "publish": "node -r dotenv/config node_modules/.bin/electron-forge publish"
  }
}
```
运行npm run publish执行发布操作。
验证环境变量加载状态
在forge.config.js中添加打印代码，确认变量是否成功读取：
```
console.log('GITHUB_TOKEN:', process.env.GITHUB_TOKEN);
```
若输出undefined，需重新检查.env文件路径和dotenv配置。
检查token权限
确保GitHub的个人访问令牌（GITHUB_TOKEN）拥有repo权限（含public_repo、repo:status等），可在GitHub个人设置-开发者设置-Personal access tokens中调整权限。