IntelliJ IDEA
IntelliJ IDEA 是 JetBrains 公司开发的 Java 集成开发环境（IDE），是 EnderRealm 项目推荐的开发工具。
什么是 IDE？
IDE（Integrated Development Environment）是集成开发环境，它将多种开发工具集成在一起：
- 代码编辑器：编写和编辑代码
- 编译器：将源代码编译成可执行程序
- 调试器：帮助查找和修复程序错误
- 项目管理：管理项目文件和依赖
- 版本控制：集成 Git 等版本控制工具
为什么推荐 IntelliJ IDEA？
IntelliJ IDEA 是 Java 开发的首选 IDE，具有以下优点：
- 智能代码补全：根据上下文提供精准的代码建议
- 强大的重构：安全地重命名、提取方法等
- 深度代码分析：检测潜在的错误和代码异味
- 丰富的插件：支持各种框架和工具
- 优秀的 Gradle 支持：完美支持 Gradle 构建系统
版本选择
IntelliJ IDEA 采用订阅制，分为两种订阅：
| 订阅 | 价格 | 说明 |
|---|---|---|
| Community | 免费 | 基础功能，足够用于本项目 |
| Ultimate | 付费 | 更多高级功能 |
提示
IntelliJ IDEA 已将社区版和终极版合并为同一软件，区别在于订阅类型。免费版已支持数据库功能。EnderRealm 项目使用免费版即可。
安装 IntelliJ IDEA
Windows
方法一：官方安装包（推荐）
- 访问 JetBrains 官网
- 下载 Community 版本安装包
- 运行安装包，按提示完成安装
- 建议勾选：
- Add "bin" folder to PATH
- Create Desktop Shortcut
- Add "Open Folder as Project"
方法二：使用包管理器
powershell
# 使用 winget
winget install JetBrains.IntelliJIDEA
# 使用 scoop
scoop install intellij-idea
# 使用 chocolatey
choco install intellijideamacOS
方法一：使用 Homebrew（推荐）
bash
brew install --cask intellij-idea方法二：官方安装包
- 访问 JetBrains 官网
- 下载 Community 版本安装包
- 拖动应用到 Applications 文件夹
Linux
Ubuntu/Debian
bash
# 使用 snap
sudo snap install intellij-idea --classic
# 或使用官方安装包
# 1. 下载 tar.gz 安装包
# 2. 解压到 /opt 目录
sudo tar -xzf ideaIC-*.tar.gz -C /opt/
# 3. 创建桌面快捷方式
/opt/idea-IC/bin/idea.shCentOS/RHEL/Fedora
bash
# 使用 snap
sudo snap install intellij-idea --classic
# 或使用官方安装包（同 Ubuntu）首次启动配置
1. 导入设置
首次启动时，可以选择：
- Do not import settings：不导入任何设置（推荐新用户）
- Import settings：导入之前版本的设置
2. 选择主题
选择你喜欢的主题：
- Darcula：暗色主题（推荐）
- Light：亮色主题
3. 安装插件
建议安装以下插件：
- Chinese (Simplified) Language Pack：中文语言包
- Gradle：Gradle 支持（通常已内置）
- Git：Git 支持（通常已内置）
4. 配置 JDK
- 打开项目后，进入
File → Project Structure → SDKs - 点击
+号，选择Add JDK - 选择 JDK 21 安装目录
- 同样添加 JDK 17
导入 EnderRealm 项目
方法一：从 Git 克隆
- 打开 IntelliJ IDEA
- 选择
Get from VCS - 输入仓库 URL：
https://github.com/EnderRealmMC/EnderRealmServerCore.git - 选择本地目录
- 点击
Clone - 等待项目下载和索引完成
方法二：打开现有项目
- 打开 IntelliJ IDEA
- 选择
Open - 选择 EnderRealm 项目目录
- 等待项目索引完成
项目配置
配置 Gradle
- 进入
File → Settings → Build, Execution, Deployment → Build Tools → Gradle - 设置：
- Distribution: Wrapper（推荐）
- JDK: 选择 JDK 21
配置项目 SDK
- 进入
File → Project Structure → Project - 设置：
- SDK: 选择 JDK 21
- Language level: 21
配置模块 SDK
- 进入
File → Project Structure → Modules - 为每个模块设置：
- Dependencies → Module SDK: 选择 JDK 21
常用快捷键
编辑操作
| 快捷键 | 功能 |
|---|---|
Ctrl + Space | 代码补全 |
Ctrl + Shift + Space | 智能代码补全 |
Ctrl + / | 注释/取消注释 |
Ctrl + D | 复制当前行 |
Ctrl + Y | 删除当前行 |
Ctrl + Alt + L | 格式化代码 |
Ctrl + Alt + O | 优化导入 |
导航操作
| 快捷键 | 功能 |
|---|---|
Ctrl + N | 查找类 |
Ctrl + Shift + N | 查找文件 |
Ctrl + F | 查找 |
Ctrl + R | 替换 |
Ctrl + G | 跳转到行 |
Alt + F7 | 查找用法 |
重构操作
| 快捷键 | 功能 |
|---|---|
Shift + F6 | 重命名 |
Ctrl + Alt + M | 提取方法 |
Ctrl + Alt + V | 提取变量 |
Ctrl + Alt + F | 提取字段 |
调试操作
| 快捷键 | 功能 |
|---|---|
F8 | Step Over |
F7 | Step Into |
Shift + F8 | Step Out |
F9 | Resume |
Ctrl + F8 | Toggle Breakpoint |
常见问题
Q: 项目导入后无法识别为 Gradle 项目？
A: 右键点击 build.gradle.kts 文件，选择 Import Gradle Project。
Q: 编译时提示 JDK 版本错误？
A: 检查以下配置：
File → Project Structure → Project → SDKFile → Project Structure → Modules → Dependencies → Module SDKFile → Settings → Build, Execution, Deployment → Build Tools → Gradle → Gradle JDK
Q: 如何运行 Gradle 任务？
A: 打开右侧的 Gradle 面板，展开任务树，双击要运行的任务。
Q: 代码补全不工作怎么办？
A: 尝试以下操作：
File → Invalidate Caches → Invalidate and Restart- 重建项目：
Build → Rebuild Project
推荐学习资源
下一步
IntelliJ IDEA 安装配置完成后，让我们继续学习 Markdown 语法基础。