Become a sponsor
1.5 技术栈说明
概述
本页列出前后端技术选型与版本基线。版本号以 go.mod 与 ui/package.json 为准，升级前请以这两个文件的实际内容核对。
后端技术栈
| 类别 | 选型 | 版本 | 说明 |
|---|---|---|---|
| 语言 | Go | 1.27 | module 名 easygoadmin |
| Web 框架 | gin-gonic/gin | v1.12 | 路由、绑定、中间件 |
| ORM | gorm.io/gorm | v1.31 | 钩子、软删除、事务 |
| MySQL 驱动 | go-sql-driver/mysql | v1.10 | gorm.io/driver/mysql |
| PostgreSQL 驱动 | jackc/pgx/v5 | v5.11 | gorm.io/driver/postgres |
| SQL Server 驱动 | microsoft/go-mssqldb | v1.11 | gorm.io/driver/sqlserver |
| SQLite 驱动 | glebarez/sqlite | v1.11 | 纯 Go 实现，免 CGO |
| Oracle 驱动 | godror/godror | v0.51 | 构建标签 -tags oracle 启用 |
| JWT | golang-jwt/jwt/v5 | v5.3 | Token 签发与解析 |
| 校验 | go-playground/validator/v10 | v10.30 | binding 标签驱动 |
| 缓存 | redis/go-redis/v9 | v9.23 | 失败自动降级内存 |
| 日志 | go.uber.org/zap | v1.28 | 结构化日志 |
| 定时任务 | robfig/cron/v3 | v3.0 | 表达式调度 |
| Excel | xuri/excelize/v2 | v2.11 | 导入导出 |
| 监控 | prometheus/client_golang | v1.25 | metrics 中间件 |
| IP 归属地 | ip2region/binding/golang | — | 离线查询 |
| 加密 | golang.org/x/crypto | v0.58 | bcrypt 等 |
前端技术栈
| 类别 | 选型 | 版本 | 说明 |
|---|---|---|---|
| 框架 | Vue | ^3.4 | Composition API |
| 语言 | TypeScript | ^4.9 | 类型安全 |
| 构建 | Vite | ^3.2 | 开发服务器 8001 端口 |
| UI 库 | ElementPlus | ^2.7 | 组件体系 |
| 状态管理 | Pinia | ^2.1 | store 见 ui/src/store |
| 路由 | vue-router | ^4.3 | 动态菜单路由生成 |
| HTTP | axios | ^0.27 | 拦截器统一封装 |
| 图表 | echarts | ^5.5 | 监控图表 |
| 富文本 | TinyMCE / @vueup/vue-quill | 5.10 / 1.0-beta | 双编辑器可选 |
| Excel | xlsx | ^0.18 | 前端导入导出 |
| 图片裁剪 | cropperjs / vue-cropper | ^1.6 / 0.5 | 头像裁剪 |
| 对象存储 | ali-oss | ^6.22 | OSS 直传支持 |
| 工具库 | lodash / dayjs / qs | — | 通用工具 |
命令行工具
| 工具 | 入口 | 用途 |
|---|---|---|
| 服务 | cmd/api | 启动 HTTP 服务（make run） |
| 代码生成器 | cmd/gen | 内省表结构生成前后端代码（make gen） |
| 数据迁移 | cmd/migrator | 跨库整库迁移（make migrator） |
构建与质量工具
| 命令 | 作用 |
|---|---|
make build | 编译到 bin/ |
make test / make test-short | 全部测试 / 跳过外部依赖的短测试 |
make check | CI 一站式：fmt-check + vet + test-short + check-config |
pnpm build | 前端生产构建 |
pnpm type:check | 前端类型检查 |
pnpm lint:eslint | 前端 ESLint 检查 |
版本升级建议
- 后端升级 Go 或 GORM 大版本前，先跑
make test-short确认无回归，再跑make test（需本地 MySQL） - 前端升级 ElementPlus 大版本时重点回归公共组件（
ui/src/components）与主题样式（ui/src/styles） - 数据库方言切换仅改
config.yaml的database节，无需改代码；跨库搬迁用make migrator