Build 指南
本章节说明 Guava 项目的开发环境搭建、本地开发、生产构建与部署流程，分为前端与后端两部分。
前端
| 章节 | 说明 |
|---|---|
| 环境要求 | Node.js、pnpm、编辑器与仓库结构 |
| 本地开发 | 安装依赖、启动 dev、目录说明 |
| 生产构建 | build 命令、产物结构、构建优化 |
| 部署上线 | 预览、Nginx 配置、常见问题 |
常用命令
bash
pnpm install # 安装依赖
pnpm dev # 本地开发
pnpm build # 生产构建
pnpm preview # 预览构建结果
pnpm clean # 彻底删除本地依赖和锁文件，并清理 pnpm 全局存储中无用的包
pnpm clean:cache # 清理 pnpm 全局存储中无用的包技术栈
| 技术 | 用途 |
|---|---|
| Vite | 构建工具 |
| Vue 3 | 前端框架 |
| guava-ui | UI组件库 |
| Element Plus | 底层UI库 |
| TypeScript | 类型检查 |
| Vue Router | 路由库 |
| Pinia | 状态管理库 |
| vue-i18n | 国际化库 |
后端
| 章节 | 说明 |
|---|---|
| 环境要求 | JDK 25、Gradle、编辑器与仓库结构 |
| 本地开发 | IDEA 配置、启动服务、API 文档 |
| 生产构建 | bootJar 命令、产物结构、构建优化 |
| 部署上线 | OAK 配置、CI/CD、回滚 |
常用命令
bash
./gradlew build # 完整构建（含测试）
./gradlew bootJar # 打包可执行 JAR（跳过测试）
./gradlew clean # 清理构建产物
./gradlew bootRun # 本地启动（默认 dev profile）
./gradlew dependencies # 查看依赖树
./gradlew publish # 发布到内部 Nexus技术栈
| 技术 | 用途 |
|---|---|
| Spring Boot 3.5 | 应用框架 |
| Spring Cloud | 微服务框架 |
| Gradle 9.6 | 构建工具 |
| OpenJDK 25 | 运行环境 |
| MyBatis Plus | ORM 框架 |
| Nacos | 配置中心 / 服务发现 |
| Knife4j | API 文档 |
| Lombok | 代码生成 |
| SkyWalking | 链路追踪 |
| Hutool | 工具类库 |