Electron打包Mac OSX应用时simple-git执行Git Clone失败

问题根源 #

你遇到的错误并非来自clone操作，而是因为代码中先执行了.clean(CleanOptions.FORCE)——这个方法仅针对已存在的Git仓库生效。开发模式下，目标目录可能已经克隆过仓库，所以clean能正常运行；但打包后首次启动时，目标目录不是Git仓库，clean就会抛出fatal: not a git repository错误，中断后续的克隆流程。

另外还有两个潜在问题：

• 目标路径.Users/user_name格式错误，Mac用户目录的正确绝对路径应为/Users/user_name，打包后相对路径容易因工作目录变化失效；
• SSH密钥路径在打包后可能无法被正确访问，导致Git SSH认证失败。

解决方案 #

1. 移除clean操作，改用目录清理

克隆操作本身会创建全新的Git仓库，无需提前执行clean。如果需要确保目标目录干净，可直接删除已存在的目标目录：

const { app } = require('electron');
const simpleGit = require('simple-git');
const fs = require('fs').promises;
const path = require('path');

// 获取用户主目录的绝对路径，拼接目标克隆目录
const targetDir = path.join(app.getPath('home'), 'your-repo-folder');

async function cloneRepo() {
  try {
    // 强制删除已存在的目标目录（如果有）
    await fs.rm(targetDir, { recursive: true, force: true });
    
    // 执行克隆
    await simpleGit()
      .env('GIT_SSH_COMMAND', `ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -i ${path.join(app.getPath('userData'), 'my_secret_key')}`)
      .clone(
        `git@github.com:remote-repo.git`, 
        targetDir,
        ['-b', 'master', '--single-branch'] // 注意master要加引号，若为变量需确保已定义
      );
    console.log('克隆成功');
  } catch (err) {
    console.error('克隆失败:', err);
  }
}

cloneRepo();

2. 使用绝对路径避免工作目录问题

通过Electron的app.getPath()方法获取系统标准路径（如用户主目录、应用数据目录），确保打包后路径始终有效：

• app.getPath('home'): 用户主目录（如/Users/your-name）
• app.getPath('userData'): 应用专属数据目录（如/Users/your-name/Library/Application Support/YourApp）

3. 确保SSH密钥可访问

将SSH密钥放在userData目录下（避免打包时被混淆或路径失效），或通过process.resourcesPath访问打包到应用内的资源文件：

// 若密钥打包在应用的resources目录下
const keyPath = path.join(process.resourcesPath, 'my_secret_key');

4. 配置Mac应用权限

打包时需确保应用有文件系统访问权限，在package.json的打包配置中添加权限声明：

"build": {
  "mac": {
    "entitlements": "entitlements.plist",
    "entitlementsInherit": "entitlements.plist"
  }
}

创建entitlements.plist文件，添加文件访问权限：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>com.apple.security.files.user-selected.read-write</key>
  <true/>
  <key>com.apple.security.files.downloads.read-write</key>
  <true/>
</dict>
</plist>

排除CORS问题 #

CORS是浏览器端的跨域限制，Electron打包后的原生应用不存在该问题，无需考虑。

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