vifo
a7f3ee3565
同步仓库名称变更，涉及 16 个文件 66 处引用： - ai-skills: 菜单配置 - backend/guides: AI操作手册、环境配置、部署、gitnexus、opencode 工作流 - backend: 模块创建规则、通信规范、协作工作流、实施规范 - frontend: 收银设计、管理后台实施计划 - standards: 数据库设计规范
182 lines
3.0 KiB
Markdown
182 lines
3.0 KiB
Markdown
# 环境搭建指南
|
||
|
||
> **适用范围**: 新加入的开发者
|
||
> **预计耗时**: 30-60 分钟
|
||
|
||
---
|
||
|
||
## 一、必要工具安装
|
||
|
||
### 1.1 JDK 21
|
||
|
||
```bash
|
||
# macOS (使用 Homebrew)
|
||
brew install openjdk@21
|
||
|
||
# 验证
|
||
java -version
|
||
# Expected: openjdk version "21"
|
||
```
|
||
|
||
### 1.2 Maven 3.9+
|
||
|
||
```bash
|
||
# macOS
|
||
brew install maven
|
||
|
||
# 验证
|
||
mvn -version
|
||
# Expected: Apache Maven 3.9.x
|
||
```
|
||
|
||
### 1.3 MySQL 8.0
|
||
|
||
```bash
|
||
# macOS
|
||
brew install mysql@8.0
|
||
brew services start mysql@8.0
|
||
|
||
# 验证
|
||
mysql --version
|
||
# Expected: mysql Ver 8.0.x
|
||
```
|
||
|
||
### 1.4 Node.js 18+ 和 pnpm
|
||
|
||
```bash
|
||
# macOS
|
||
brew install node@18
|
||
npm install -g pnpm
|
||
|
||
# 验证
|
||
node --version
|
||
pnpm --version
|
||
```
|
||
|
||
### 1.5 Git
|
||
|
||
```bash
|
||
# macOS
|
||
brew install git
|
||
|
||
# 验证
|
||
git --version
|
||
```
|
||
|
||
---
|
||
|
||
## 二、项目初始化
|
||
|
||
### 2.1 克隆项目
|
||
|
||
```bash
|
||
git clone <repository-url>
|
||
cd rui-framework
|
||
```
|
||
|
||
### 2.2 配置本地开发环境
|
||
|
||
```bash
|
||
# 创建本地配置文件
|
||
cp backend/config/application-dev.yml.example backend/config/application-dev.yml
|
||
|
||
# 编辑配置（使用你的数据库连接信息）
|
||
# vim backend/config/application-dev.yml
|
||
```
|
||
|
||
配置示例：
|
||
```yaml
|
||
spring:
|
||
datasource:
|
||
url: jdbc:mysql://localhost:3306/rui_platform?useUnicode=true&characterEncoding=utf8
|
||
username: root
|
||
password: your_password
|
||
```
|
||
|
||
### 2.3 初始化数据库
|
||
|
||
```bash
|
||
# 创建数据库
|
||
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS rui_platform CHARACTER SET utf8mb4;"
|
||
|
||
# 执行初始化脚本
|
||
mysql -u root -p rui_platform < sql/init-database.sql
|
||
```
|
||
|
||
### 2.4 编译项目
|
||
|
||
```bash
|
||
cd backend
|
||
mvn clean install -DskipTests
|
||
```
|
||
|
||
Expected: `BUILD SUCCESS`
|
||
|
||
---
|
||
|
||
## 三、IDE 配置
|
||
|
||
### 3.1 IntelliJ IDEA
|
||
|
||
1. 打开项目（选择 backend/pom.xml）
|
||
2. 启用 Annotation Processing：
|
||
- Settings → Build → Annotation Processors
|
||
- 勾选 "Enable annotation processing"
|
||
3. 配置代码风格：
|
||
- Settings → Editor → Code Style → Java
|
||
- Import Scheme → Project
|
||
|
||
### 3.2 VS Code（前端）
|
||
|
||
1. 安装推荐插件：
|
||
- ESLint
|
||
- Prettier
|
||
- Vue Language Features
|
||
2. 配置自动格式化：
|
||
```json
|
||
{
|
||
"editor.formatOnSave": true,
|
||
"editor.defaultFormatter": "esbenp.prettier-vscode"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 四、验证清单
|
||
|
||
完成以上步骤后，请确认：
|
||
|
||
- [ ] `java -version` 显示 JDK 21
|
||
- [ ] `mvn -version` 显示 Maven 3.9+
|
||
- [ ] `mysql --version` 显示 MySQL 8.0+
|
||
- [ ] `backend/mvn clean install -DskipTests` 执行成功
|
||
- [ ] 数据库 `rui_platform` 已创建
|
||
- [ ] IntelliJ IDEA 已配置 Annotation Processing
|
||
|
||
---
|
||
|
||
## 五、常见问题
|
||
|
||
### Q1: Maven 编译失败
|
||
|
||
**可能原因**: JDK 版本不对
|
||
**解决**: 确认 `JAVA_HOME` 指向 JDK 21
|
||
|
||
```bash
|
||
export JAVA_HOME=$(/usr/libexec/java_home -v 21)
|
||
```
|
||
|
||
### Q2: 数据库连接失败
|
||
|
||
**可能原因**: MySQL 未启动或配置错误
|
||
**解决**:
|
||
```bash
|
||
brew services start mysql
|
||
# 检查 application-dev.yml 中的连接信息
|
||
```
|
||
|
||
### Q3: Lombok 注解不生效
|
||
|
||
**可能原因**: Annotation Processing 未启用
|
||
**解决**: 按 3.1 节启用
|