manta/gofaster/QUICK_START.md

# 🚀 GoFaster 快速启动指南

## 📋 启动方式总览

### **🎯 多种启动方式**

#### **方式 1: PowerShell 脚本（推荐）**
```powershell
# 右键选择"使用 PowerShell 运行"
.\start.ps1

# 或者在 PowerShell 中运行
.\start.ps1
```

#### **方式 2: 批处理文件**
```bash
# 双击运行（如果仍有编码问题，使用方式1）
start-dev.bat

# 或者使用英文版本
start-simple.bat
```

#### **方式 3: 直接启动**
```powershell
# 全栈启动（标准模式）
.\dev-full.ps1

# 全栈启动（调试模式）
.\dev-full.ps1 -Debug

# 全栈启动（监听模式）
.\dev-full.ps1 -Watch
```

### **⚡ 直接启动**
```powershell
# 全栈启动（标准模式）
.\dev-full.ps1

# 全栈启动（调试模式）
.\dev-full.ps1 -Debug

# 全栈启动（监听模式）
.\dev-full.ps1 -Watch
```

### **🔧 灵活启动**
```powershell
# 仅启动后端
.\dev-full.ps1 -BackendOnly

# 仅启动前端
.\dev-full.ps1 -FrontendOnly
```

## 🚀 推荐启动流程

### **1. 首次使用**
```bash
# 双击运行
start-dev.bat

# 选择选项 1: 全栈启动
```

### **2. 日常开发**
```bash
# 选择选项 3: 监听模式（自动重载）
start-dev.bat
```

### **3. 调试问题**
```bash
# 选择选项 2: 调试模式（详细日志）
start-dev.bat
```

## 📁 文件说明

| 文件 | 说明 | 用途 |
|------|------|------|
| `start-dev.bat` | 快速启动菜单 | 一键选择启动模式 |
| `dev-full.ps1` | 增强版全栈脚本 | 智能启动前后端 |
| `app/dev-enhanced.ps1` | 前端增强脚本 | 仅启动前端 |
| `backend/dev.ps1` | 后端启动脚本 | 仅启动后端 |

## 🔧 功能特性

### **✅ 已解决的问题**
- 🎯 中文乱码问题
- 📊 日志信息少的问题
- 🔄 热重载不工作的问题
- 📦 依赖管理问题

### **🚀 新增功能**
- 🧠 智能依赖检查
- 📱 进程管理和监控
- 🎨 友好的用户界面
- ⚡ 多种启动模式

## 💡 使用技巧

### **开发阶段**
1. **开始开发**：使用监听模式，自动重载
2. **调试问题**：使用调试模式，查看详细日志
3. **测试功能**：使用标准模式，稳定运行

### **维护阶段**
1. **仅修改前端**：使用 `-FrontendOnly` 模式
2. **仅修改后端**：使用 `-BackendOnly` 模式
3. **全栈开发**：使用标准模式

## 🚨 常见问题

### **Q: 启动失败怎么办？**
A: 使用调试模式 `.\dev-full.ps1 -Debug` 查看详细错误信息

### **Q: 中文显示乱码？**
A: 脚本已自动设置 UTF-8 编码，确保使用 PowerShell 或 CMD

### **Q: 端口被占用？**
A: 脚本会自动检查端口状态，如有冲突会提示解决方案

### **Q: 依赖安装失败？**
A: 脚本会自动检查和安装依赖，如失败会提供手动安装指导

## 🎯 下一步

1. **立即体验**：双击 `start-dev.bat`
2. **查看文档**：阅读 `FULL_STACK_ENHANCED.md`
3. **自定义配置**：修改 `app/vue.config.js`
4. **反馈问题**：记录遇到的问题和解决方案

---

**🎉 现在你可以享受无乱码、详细日志、智能管理的开发环境了！**