manta/gofaster/QUICK_START.md

🚀 GoFaster 快速启动指南

📋 启动方式总览

🎯 多种启动方式

方式 1: PowerShell 脚本（推荐）

# 右键选择"使用 PowerShell 运行"
.\start.ps1

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

方式 2: 批处理文件

# 双击运行（如果仍有编码问题，使用方式1）
start-dev.bat

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

方式 3: 直接启动

# 全栈启动（标准模式）
.\dev-full.ps1

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

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

⚡ 直接启动

# 全栈启动（标准模式）
.\dev-full.ps1

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

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

🔧 灵活启动

# 仅启动后端
.\dev-full.ps1 -BackendOnly

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

🚀 推荐启动流程

1. 首次使用

# 双击运行
start-dev.bat

# 选择选项 1: 全栈启动

2. 日常开发

# 选择选项 3: 监听模式（自动重载）
start-dev.bat

3. 调试问题

# 选择选项 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. 反馈问题：记录遇到的问题和解决方案

---

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