Skip to content

场景一:基础全栈项目

本场景演示用 gvt init 创建一个带 Vue 3 Portal 前端与 MySQL ORM 的常规全栈项目。

目标

  • 后端:Gin + GORM + MySQL,分层架构
  • 前端:Vue 3 Portal(Vite + TypeScript)
  • 统一 pre-commit 代码检查(后续用 gvt add 安装)

步骤

1. 初始化

bash
gvt init

表单填写:

1/10 ─ Project Name:              shop
2/10 ─ Go Module Path:            github.com/user/shop
3/10 ─ Description:               电商示例
4/10 ─ Author:                    liumou
5/10 ─ Frontend Tech Stack:       [x] Vue 3 Portal
6/10 ─ Allow Inline Styles?       No
7/10 ─ Package Manager:           pnpm
8/10 ─ ORM Framework:             GORM + MySQL
9/10 ─ Use Docker?                No
10/10 ─ Init Git Repository?      Yes

2. 启动后端

bash
cd shop
go run ./backend/cmd/server

3. 启动前端

bash
cd shop/frontend/portal
npm install
npm run dev

4. 安装钩子检查

bash
gvt add
bash scripts/install-hooks.sh

生成要点

  • 后端自动创建管理员账号(ADMIN_USERNAME / ADMIN_PASSWORD,默认 admin / admin123)。
  • 前端覆盖规范化目录(api/router/stores/views/utils/styles)。
  • 行数检查阈值:警告 250 行、错误 300 行。

验证

bash
curl http://localhost:8080/health

返回 {"code":0,"message":"ok","data":null} 即表示后端就绪。

基于 MIT 协议开源