快速开始

组件	版本要求	说明
Go	1.18+	后端服务运行环境
Node.js	16+	前端构建工具
Docker	20.10+	容器运行环境（可选）
MySQL/PostgreSQL	8.0+ / 12+	数据库
Redis	6.0+	缓存和消息队列
MinIO		文件存储

开发工具安装

macOS

# 使用 Homebrew 安装
brew install go node docker

# 安装 pnpm（推荐的包管理器）
npm install -g pnpm

Ubuntu/Debian

# 安装 Go
wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装 pnpm
npm install -g pnpm

# 安装 Docker
sudo apt-get install docker.io docker-compose

Windows

# 使用 Chocolatey 安装
scoop install golang nodejs docker-desktop

# 安装 pnpm
npm install -g pnpm

四、快速启动（以 Admin 为例）

第一步：克隆代码仓库

git clone https://github.com/tx7do/go-wind-admin.git
cd go-wind-admin

第二步：启动后端服务

cd backend

# 首次运行需要执行准备脚本
./script/prepare.sh

# 安装依赖工具和插件
make init

# 启动服务（推荐方式）
gow run admin

# 或者使用传统方式
cd app/admin/service
make run

# 服务将在 http://localhost:7788 启动

第三步：启动前端服务

cd ../frontend

# 安装前端依赖
pnpm install

# 启动开发服务
pnpm dev:antd

# 前端将在 http://localhost:5555 启动

第四步：访问应用

管理页面：http://localhost:5555
API 文档：http://localhost:7788/docs/
默认账号：admin / admin

五、Docker Compose 快速启动

如果您希望使用 Docker 启动完整的开发环境（包含数据库、Redis 等依赖）：

# 在项目根目录执行
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

更多详细说明请参考各产品的安装文档。

六、常见问题

Q: 可以用什么编辑器开发？

A: 推荐使用：

Go 后端：VS Code（Go 扩展）、GoLand、Vim
Vue3 前端：VS Code（Volar 扩展）、WebStorm

Q: 如何切换数据库为 PostgreSQL？

A: 修改 backend/app/admin/service/configs/config.yaml 中的数据库配置，将 mysql 改为 postgres。

Q: 前端开发时支持热加载吗？

A: 支持，使用 pnpm dev:antd 命令时已自动启用 Vite 热加载。

Q: 如何部署到生产环境？

A: 请参考各产品的部署指南，或联系社区获取帮助。

七、获取帮助

📖 文档：GoWind 官方文档
🐛 问题反馈：GitHub Issues
💬 社区讨论：GitHub Discussions
📧 邮件支持：yanglinbo@gmail.com

八、下一步

祝您使用愉快！