1.5 技术栈说明
:::tip 概述
本页列出前后端技术选型与版本基线。版本号以 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
