CircleCI构建Electron Windows应用遇prlctl ENOENT错误求助

错误原因分析 #

这个错误的核心是系统找不到prlctl命令：

• prlctl是Parallels Desktop的命令行工具，用于管理Parallels虚拟机，通常在本地Mac开发环境中用来通过虚拟机打包Windows应用
• Mac构建正常是因为打包Mac应用不需要依赖Parallels，直接本地即可完成；而Windows构建时，Electron Builder尝试调用prlctl启动虚拟机，但CircleCI的构建环境中没有安装Parallels，也没有配置对应的Windows虚拟机，因此抛出ENOENT（文件/命令不存在）错误

解决方案 #

1. 改用CircleCI原生Windows执行器构建 #

这是最可靠的方案，直接在Windows环境中打包Windows应用，避免依赖Parallels：
在.circleci/config.yml中添加Windows构建任务：

version: 2.1
executors:
  windows-executor:
    machine:
      image: windows-server-2022-gui:current
      shell: powershell.exe

jobs:
  build-windows:
    executor: windows-executor
    steps:
      - checkout
      - run: choco install nodejs --version=18.17.0
      - run: npm install
      - run: npm run build:windows # 替换为你的Windows构建命令

2. 调整Electron Builder配置，禁用Parallels依赖 #

如果必须在Mac环境打包Windows，需要：

• 确保CircleCI的Mac构建机器安装了Parallels Desktop和激活的Windows虚拟机，且prlctl已加入系统PATH
• 或修改package.json中的Electron Builder配置，强制使用非虚拟机方式（如wine，兼容性有限）：

{
  "build": {
    "win": {
      "target": "nsis",
      "wine": true,
      "disableParallelBuilding": true
    }
  }
}

3. 检查构建脚本参数 #

确认你的构建命令中是否包含--parallels这类强制使用Parallels的参数，若有则移除，让Electron Builder自动适配CircleCI环境

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