# goobye

**Repository Path**: xmh3000/goobye

## Basic Information

- **Project Name**: goobye
- **Description**: 基于electron + vue3 + element-plus的浏览器程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Goobye Browser

An Enterprise Browser based on Electron + Vue + Element Plus

## 技术栈

- [Electron](https://www.electronjs.org/)
- [Vue 3](https://v3.vuejs.org/)
- [Vite](https://vitejs.dev/)
- [electron-vite](https://electron-vite.org/)
- [Element Plus](https://element-plus.org/)
- [Pinia](https://pinia.vuejs.org/)
- [Vue Router](https://router.vuejs.org/)

## 项目创建

该项目使用以下命令创建:

```bash
npm create @quick-start/electron@latest goobye -- --template vue
```

## 推荐的 IDE 设置

- [VSCode](https://code.visualstudio.com/) + [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) + [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar)

## 项目设置

### 安装依赖

使用 pnpm 安装项目依赖：

```bash
pnpm install
```

### 开发环境

启动开发服务器：

```bash
pnpm run dev
```

### 构建应用

构建生产版本的应用程序：

```bash
# 对于 Windows
pnpm run build:win

# 对于 macOS
pnpm run build:mac

# 对于 Linux
pnpm run build:linux

# 仅打包不构建
pnpm run build:unpack
```

### 其他命令

```bash
# 格式化代码
pnpm run format

# 代码检查
pnpm run lint

# 预览构建结果
pnpm run start
```

## 项目结构

```
├─┬ src
│ ├─┬ main
│ │ ├── index.js           # 主进程入口文件
│ │ └─┬ modules
│ │   ├── security.js      # 安全模块
│ │   └── ipc.js           # IPC通信模块
│ ├─┬ preload
│ │ └── index.js           # 预加载脚本
│ └─┬ renderer
│   ├── index.html         # 渲染进程页面
│   └─┬ src
│     ├── main.js          # 渲染进程入口文件
│     ├── App.vue          # 主要的 Vue 组件
│     ├── views            # 视图组件
│     ├── components        # UI组件
│     ├── router           # 路由配置
│     ├── store            # 状态管理
│     └── assets           # 静态资源
├── resources              # 资源文件
└── build                  # 构建相关文件
├── electron.vite.config.mjs  # Electron-Vite 配置文件
├── electron-builder.yml      # Electron Builder 配置文件
├── package.json              # 项目配置文件
└── README.md                 # 项目说明文档
```

## 解决常见问题

### Electron uninstall 错误

如果在运行 `pnpm run dev` 时遇到 "Error: Electron uninstall" 错误，请按照以下步骤操作：

1. 清理 pnpm 缓存:
   ```bash
   pnpm store prune
   ```

2. 强制重新安装 Electron:
   ```bash
   pnpm install electron -D --force
   ```

3. 批准构建脚本:
   ```bash
   pnpm approve-builds
   ```
   在交互界面中选择所有选项 (electron, electron-winstaller, esbuild)

4. 再次运行开发服务器:
   ```bash
   pnpm run dev
   ```

## 自定义配置

请参考以下文档进行自定义配置：

- [Electron Vite Documentation](https://electron-vite.org/)
- [Electron Builder Documentation](https://www.electron.build/)
- [Vue 3 Documentation](https://v3.vuejs.org/guide/introduction.html)