docs(readme): 添加项目启动和编译问题解决方案文档
- 新增 FIX_COMPILE.md 文件,提供修复IDE编译问题的四种方法 - 新增 HOW_TO_START.md 文件,详细说明如何正确启动后端服务 - 强调必须启动 mt-pay 模块的 MtPayApplication 类 - 提供 IntelliJ IDEA 和 Maven 两种启动方式 - 列出常见启动错误及解决方案 - 添加快速检查清单帮助验证启动状态
This commit is contained in:
108
FIX_COMPILE.md
Normal file
108
FIX_COMPILE.md
Normal file
@@ -0,0 +1,108 @@
|
||||
# 修复编译问题指南
|
||||
|
||||
## 问题描述
|
||||
IDE提示"Java file is located outside of the module source root, so it won't be compiled"
|
||||
|
||||
## 解决步骤
|
||||
|
||||
### 方法1:在 IntelliJ IDEA 中重新导入项目(推荐)
|
||||
|
||||
1. **关闭项目**
|
||||
- File → Close Project
|
||||
|
||||
2. **重新打开项目**
|
||||
- File → Open
|
||||
- 选择 `E:\MTKJPAY` 目录
|
||||
- 选择 "Open as Project"
|
||||
|
||||
3. **等待 Maven 导入完成**
|
||||
- 右下角会显示 "Importing Maven projects..."
|
||||
- 等待完成
|
||||
|
||||
4. **刷新 Maven 项目**
|
||||
- 右键根目录项目 → Maven → Reload Project
|
||||
- 或者:View → Tool Windows → Maven → 点击刷新按钮
|
||||
|
||||
5. **重新构建项目**
|
||||
- Build → Rebuild Project
|
||||
|
||||
### 方法2:手动配置 Source Root
|
||||
|
||||
1. **打开项目结构**
|
||||
- File → Project Structure (Ctrl+Alt+Shift+S)
|
||||
|
||||
2. **检查 Modules**
|
||||
- 左侧选择 "Modules"
|
||||
- 确认有两个模块:
|
||||
- `MTKJPAY` (根模块)
|
||||
- `mt-pay` (子模块)
|
||||
|
||||
3. **配置 MTKJPAY 模块**
|
||||
- 选择 `MTKJPAY` 模块
|
||||
- 在 "Sources" 标签页
|
||||
- 确认 `src/main/java` 标记为蓝色(Source Folders)
|
||||
- 确认 `src/main/resources` 标记为绿色(Resources Folders)
|
||||
- 如果没有标记,右键文件夹 → Mark Directory as → Sources Root / Resources Root
|
||||
|
||||
4. **配置 mt-pay 模块**
|
||||
- 选择 `mt-pay` 模块
|
||||
- 在 "Sources" 标签页
|
||||
- 确认 `mt-pay/src/main/java` 标记为蓝色
|
||||
- 确认 `mt-pay/src/main/resources` 标记为绿色
|
||||
|
||||
5. **应用并确定**
|
||||
- 点击 "Apply" → "OK"
|
||||
|
||||
### 方法3:使用 Maven 命令编译
|
||||
|
||||
```bash
|
||||
# 进入项目根目录
|
||||
cd E:\MTKJPAY
|
||||
|
||||
# 清理并编译
|
||||
mvn clean compile
|
||||
|
||||
# 或者安装到本地仓库
|
||||
mvn clean install
|
||||
```
|
||||
|
||||
### 方法4:检查 IDE 设置
|
||||
|
||||
1. **检查 Maven 设置**
|
||||
- File → Settings → Build, Execution, Deployment → Build Tools → Maven
|
||||
- 确认 "Maven home directory" 正确
|
||||
- 确认 "User settings file" 正确
|
||||
|
||||
2. **检查 Java 设置**
|
||||
- File → Settings → Build, Execution, Deployment → Compiler → Java Compiler
|
||||
- 确认 "Project bytecode version" 是 17
|
||||
|
||||
3. **检查项目 SDK**
|
||||
- File → Project Structure → Project
|
||||
- 确认 "SDK" 是 Java 17
|
||||
- 确认 "Language level" 是 17
|
||||
|
||||
## 验证修复
|
||||
|
||||
编译成功后:
|
||||
1. 在 IDE 中,Java 文件不应该有红色波浪线
|
||||
2. 可以正常启动 `MtkjpayApplication`
|
||||
3. 控制台没有编译错误
|
||||
|
||||
## 如果仍然有问题
|
||||
|
||||
1. **删除 .idea 文件夹**(需要关闭项目)
|
||||
- 关闭 IntelliJ IDEA
|
||||
- 删除 `E:\MTKJPAY\.idea` 文件夹
|
||||
- 重新打开项目
|
||||
|
||||
2. **删除 target 文件夹**
|
||||
```bash
|
||||
cd E:\MTKJPAY
|
||||
rmdir /s /q target
|
||||
rmdir /s /q mt-pay\target
|
||||
```
|
||||
|
||||
3. **重新导入项目**
|
||||
- 按照方法1重新导入
|
||||
|
||||
Reference in New Issue
Block a user