IntelliJ IDEA 首次安装后推荐的插件完整指南

一、插件选择原则

在选择插件时，应遵循以下原则：

• 必要性：解决实际开发痛点
• 稳定性：选择官方或高评分插件
• 兼容性：确保与当前 IDEA 版本兼容
• 轻量性：避免安装过多插件影响性能

---

二、核心必备插件

一、代码生成与增强类插件

1.1 Lombok

插件作用

• 支持 Lombok 注解（@Data, @Getter, @Setter, @Builder, @Slf4j 等）
• 在编辑器中正确识别 Lombok 生成的代码
• 提供代码补全、导航和重构支持

必要配置

路径：Settings → Build, Execution, Deployment → Compiler → Annotation Processors

配置项：
✓ Enable annotation processing
✓ Store generated sources relative to: Module output directory

项目依赖配置

<!-- Maven pom.xml -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.30</version>
    <scope>provided</scope>
</dependency>

常见问题解决

• 编译错误：确保启用 annotation processing
• IDE 不识别：重启 IDEA 或重新导入项目
• 版本兼容：使用与 JDK 版本兼容的 Lombok 版本

---

1.2 EasyCode

插件作用

• 基于数据库表自动生成多层架构代码
• 支持 Entity、DAO、Service、Controller 等分层生成
• 提供模板引擎，支持自定义代码模板
• 批量生成多表代码

核心配置

数据库连接配置：

路径：Settings → Other Settings → EasyCode → DataSource

配置项：
- Database type: MySQL/PostgreSQL/Oracle 等
- Connection URL: jdbc:mysql://localhost:3306/your_db
- Username: your_username  
- Password: your_password
- Schema: your_database_name

包路径配置：

路径：Settings → Other Settings → EasyCode → Package Config

包路径设置：
- Entity Package: com.yourcompany.entity
- Mapper Package: com.yourcompany.mapper
- Service Package: com.yourcompany.service
- Service Impl Package: com.yourcompany.service.impl
- Controller Package: com.yourcompany.controller

输出路径：
- Java Path: ${project.dir}/src/main/java
- XML Path: ${project.dir}/src/main/resources/mapper

全局配置：

路径：Settings → Other Settings → EasyCode → Global Config

配置项：
- Author: Your Name
- Email: your.email@company.com
- Date format: yyyy-MM-dd HH:mm:ss
- Base package: com.yourcompany

使用流程

1. 配置数据库连接
2. 在 Database 工具窗口右键表 → “EasyCode” → “Generate Code”
3. 选择生成的文件类型和模板
4. 预览并生成代码

---

1.3 MyBatisX

插件作用

• MyBatis 开发增强支持
• Mapper 接口与 XML 文件双向跳转
• 自动生成 MyBatis 相关代码
• SQL 语法检查和验证

核心配置

路径：Settings → Other Settings → MyBatisX

基本配置：
- Enable MyBatisX: ✓
- Mapper XML Path: src/main/resources/mapper/
- Enable Code Generator: ✓

跳转配置：
- Mapper Interface → XML: ✓
- XML → Mapper Interface: ✓
- DAO → XML: ✓

代码生成模板：
- 可自定义 Entity、Mapper、Service 模板
- 支持 Lombok 集成

使用技巧

• 双向跳转：在 Mapper 接口方法上按 Ctrl + B 跳转到 XML
• 代码生成：右键数据库表 → “MyBatis Generator”
• SQL 验证：XML 中的 SQL 语句会进行语法检查

---

二、依赖与构建管理类插件

2.1 Maven Helper

插件作用

• 可视化 Maven 依赖冲突检测
• 依赖树分析和搜索
• 一键排除冲突依赖
• 依赖关系可视化

核心功能

在 pom.xml 文件底部标签栏：
- Conflicts：显示版本冲突的依赖
- All Dependencies：完整依赖树
- Search：依赖搜索功能

配置选项

路径：Settings → Other Settings → Maven Helper

配置项：
- Show dependency analyzer tab: ✓
- Auto refresh on pom.xml change: ✓
- Highlight conflicts in editor: ✓
- Conflict resolution strategy: "Newest"

使用技巧

• 冲突解决：在 Conflicts 视图中右键依赖 → “Exclude”
• 快捷键：Ctrl + Alt + Shift + D 快速打开依赖分析器
• 批量操作：按住 Ctrl 多选依赖进行批量排除

---

2.2 maven-search

插件作用

• 在 Maven 仓库中搜索依赖
• 查看依赖的所有可用版本
• 一键将依赖添加到 pom.xml
• 支持私有仓库配置

核心配置

路径：Settings → Other Settings → Maven Search

仓库配置（推荐国内用户）：
- Maven Central URL: https://repo1.maven.org/maven2/
- Aliyun Mirror: https://maven.aliyun.com/repository/central

缓存配置：
- Cache search results: ✓
- Cache expiration: 24 hours
- Cache directory: ~/.m2/maven-search-cache/

搜索配置：
- Search timeout: 10 seconds
- Max results: 20
- Include snapshots: ✗

使用方法

• 快捷搜索：在 pom.xml 中按 Ctrl + Alt + M 或 Ctrl + Space
• 版本查看：点击搜索结果查看版本详情和变更日志
• 批量添加：支持多选依赖一次性添加

---

三、代码质量与规范类插件

3.1 SonarLint

插件作用

• 实时代码质量检查
• 发现潜在 bug、代码异味和安全漏洞
• 支持多种编程语言
• 可连接 SonarQube/SonarCloud

基础配置

路径：Settings → Tools → SonarLint

基础设置：
- Enable SonarLint: ✓
- Automatically analyze files on save: ✓
- Show issues in: Editor, Tool window

规则配置：
- Enable all rules by default: ✓
- 或选择特定规则集：
  ✓ Security（安全性）
  ✓ Reliability（可靠性）  
  ✓ Maintainability（可维护性）

高级配置（连接 SonarQube）

路径：Settings → Tools → SonarLint → Project Settings

绑定步骤：
1. 点击 "Bind to SonarQube/SonarCloud"
2. 选择服务器类型
3. 输入服务器 URL 和认证令牌
4. 选择对应的项目
5. 同步团队规则配置

使用技巧

• 手动分析：右键代码 → “SonarLint” → “Analyze”
• 问题修复：在问题上按 Alt + Enter 查看修复建议
• 问题查看：View → Tool Windows → SonarLint

---

四、开发效率提升类插件

4.1 Key Promoter X

插件作用

• 鼠标操作时提示对应快捷键
• 帮助减少鼠标依赖
• 统计快捷键使用频率
• 支持自定义快捷键创建

配置选项

路径：Settings → Tools → Key Promoter X

配置项：
- Show notifications: ✓
- Notification timeout: 3000ms
- Ignore actions: 添加不想提示的操作
- Statistics: 查看学习进度和使用统计

使用说明

• 无需额外配置，安装后自动工作
• 创建快捷键：点击提示中的 “Add Shortcut” 为无快捷键操作创建快捷键
• 查看统计：View → Tool Windows → Key Promoter X 查看使用数据

---

4.2 CodeGlance Pro

插件作用

• 在编辑器右侧显示代码缩略图（minimap）
• 快速定位和导航代码
• 类似 Sublime Text 的 minimap 功能

详细配置

路径：Settings → Other Settings → CodeGlance Pro

显示配置：
- Show CodeGlance: ✓
- Width: 120px（建议 100-150px）
- Position: Right
- Show scrollbar: ✗（避免重复滚动条）

外观配置：
- Background alpha: 180（透明度 0-255）
- Font size: 2（缩略图字体大小）
- Color scheme: Follow editor theme

性能配置：
- Max file size: 10MB（大文件不显示缩略图）
- Update delay: 100ms（更新延迟）

使用技巧

• 快速跳转：点击缩略图跳转到对应位置
• 滚动导航：拖拽缩略图滑块快速滚动
• 行号显示：鼠标悬停显示行号

---

4.3 Translation

插件作用

• 代码内翻译选中文本
• 支持多种翻译引擎
• 自动生成 JavaDoc 注释
• 支持专业术语翻译

引擎配置

路径：Settings → Tools → Translation

翻译引擎选择：
1. Youdao（有道翻译）- 推荐，免费且准确
2. Google Translate - 需要网络代理
3. Baidu Translate - 需要 API Key
4. Tencent Translate - 需要 API Key

快捷键配置：
- Translate: Ctrl+Shift+Y（默认）
- Quick Translate: Ctrl+Shift+Alt+Y
- Toggle Auto-Translate: Ctrl+Alt+Shift+Y

API Key 配置（以百度为例）

1. 访问百度翻译开放平台
2. 创建应用获取 App ID 和 Secret Key
3. 在插件设置中填写：
   - App ID: your_app_id
   - Secret Key: your_secret_key

高级功能

• JavaDoc 生成：选中方法名 → Alt + Insert → “Generate JavaDoc”
• 自定义词典：添加专业术语到自定义词典
• 批量翻译：选中多行文本进行批量翻译

---

五、代码可视化与可读性类插件

5.1 Rainbow Brackets Lite

插件作用

• 为不同层级的括号显示不同颜色
• 提高复杂嵌套代码的可读性
• 支持多种括号类型：(), [], {}, <>

配置选项

路径：Settings → Editor → Color Scheme → Rainbow Brackets Lite

括号类型配置：
✓ Round Brackets ()
✓ Square Brackets []  
✓ Curly Brackets {}
✓ Angle Brackets <>

颜色配置：
- Color scheme: Default（或自定义颜色）
- Max bracket depth: 10（最大嵌套层级）
- Enable in: All file types（或选择特定类型）

性能优化

• 层级限制：设置合理的最大嵌套层级避免性能问题
• 文件类型过滤：禁用不需要的文件类型
• 轻量版本：Lite 版本比完整版性能更好

---

5.2 Indent Rainbow

插件作用

• 为不同层级的缩进显示不同颜色
• 帮助快速识别代码块嵌套结构
• 容易发现缩进不一致问题

详细配置

路径：Settings → Editor → Color Scheme → Indent Rainbow

颜色配置（默认配色）：
- Level 1: #FF0000（红色）
- Level 2: #00FF00（绿色）
- Level 3: #0000FF（蓝色）  
- Level 4: #FFFF00（黄色）
- Level 5+: #FF00FF（紫色）

高级配置：
- Max indent level: 10
- Show only on hover: ✗（建议始终显示）
- Ignore empty lines: ✓
- Use background color: ✗（建议使用竖线）

文件类型配置

路径：Settings → Editor → Indent Rainbow

启用的文件类型：
✓ Java, JavaScript, TypeScript
✓ Python, Kotlin, Scala  
✓ XML, JSON, YAML
✓ HTML, CSS, SQL

禁用的文件类型：
✗ Plain text, Markdown

---

六、API 开发与文档类插件

6.1 Apipost Helper

插件作用

• 从代码注解自动生成 API 文档
• 与 Apipost 工具无缝集成
• 快速生成接口调试配置
• 自动提取接口参数和返回值

核心配置

路径：Settings → Tools → Apipost Helper

基础配置：
- Apipost Server URL: https://www.apipost.cn
- API Doc Format: "Apipost JSON"（推荐）
- Auto generate on save: ✗（建议手动控制）

注解支持配置：
✓ Spring MVC annotations
✓ Swagger annotations  
✓ Custom annotations（可扩展）

导出配置：
- Output directory: ${project.dir}/docs/api/
- File name pattern: ${controller.name}_api.json

Apipost 集成配置

账户配置：
1. 获取 Apipost API Token（个人设置 → 账户设置）
2. 在插件设置中填写 Token
3. 配置项目 ID（可选）

同步功能：
- Push to Apipost: 推送文档到云端
- Pull from Apipost: 拉取最新文档
- Sync on save: 保存时自动同步

使用流程

1. 编写注解：使用 @ApiOperation, @ApiParam 等注解
2. 生成文档：右键 Controller → “Apipost Helper” → “Generate API Doc”
3. 导出格式：选择 JSON、Markdown 或 Apipost 格式
4. 同步云端：推送至 Apipost 进行团队协作

---

七、UI/UX 增强类插件

7.1 Atom Material Icons

插件作用

• 提供 Atom 风格的文件和文件夹图标
• 增强项目文件树的视觉体验
• 支持多种文件类型图标

配置选项

路径：Settings → Editor → Material Theme → Icons

图标包选择：
- Icon Pack: Atom Material Icons
- Folder icons: ✓
- File icons: ✓
- Custom file associations: 可添加自定义文件类型

外观配置：
- Icon opacity: 0.8
- Icon saturation: 1.0
- Show icons in tabs: ✓

自定义文件关联

路径：Settings → Editor → File Types

添加自定义文件类型图标：
1. 点击 "+" 添加新的文件类型
2. 指定文件扩展名（如 .yml, .properties）
3. 选择对应的图标类型

---

八、插件组合使用最佳实践

8.1 推荐开发工作流

完整开发流程：
1. 使用 maven-search 添加项目依赖
2. 使用 Maven Helper 检测和解决依赖冲突
3. 连接数据库，使用 EasyCode 生成基础代码框架
4. 使用 MyBatisX 增强 MyBatis 开发体验
5. 使用 Lombok 简化 POJO 代码
6. 编码过程中：
   - Indent Rainbow 和 Rainbow Brackets 提升可读性
   - SonarLint 实时检查代码质量
   - Key Promoter X 学习快捷键
   - CodeGlance Pro 提供代码导航
7. 使用 Apipost Helper 生成 API 文档
8. 使用 Translation 翻译技术文档
9. Atom Material Icons 提供美观的 UI 体验

8.2 性能优化建议

内存配置

# idea64.exe.vmoptions
-Xms1024m
-Xmx4096m
-XX:ReservedCodeCacheSize=1024m
-XX:+UseG1GC

插件启用策略

• 始终启用：Lombok, Maven Helper, SonarLint, Rainbow Brackets Lite, Indent Rainbow
• 按需启用：EasyCode, MyBatisX, Apipost Helper（仅在相关项目中使用）
• 轻量使用：CodeGlance Pro（可调整宽度和透明度）

缓存管理

• 定期清理插件缓存：File → Invalidate Caches and Restart
• 配置合理的缓存过期时间（maven-search, Translation 等）

8.3 团队协作配置

配置同步

重要配置导出：
File → Manage IDE Settings → Export Settings

选择导出：
✓ Code Style
✓ Keymap
✓ Plugins settings
✓ Editor settings
✓ Build Tools settings

团队标准

• 代码模板：EasyCode 模板团队统一
• 依赖管理：maven-search 配置团队私有仓库
• 代码规范：SonarLint 连接团队 SonarQube 服务器
• API 文档：Apipost Helper 使用统一的注解标准

8.4 故障排除指南

插件冲突处理

1. 进入安全模式：Help → Safe Mode
2. 逐个禁用：确定问题插件
3. 更新版本：确保插件与 IDEA 版本兼容
4. 重新安装：卸载后重新安装问题插件

性能问题解决

• 监控内存：Help → Diagnostic Tools → Monitor VM Memory
• 禁用非必要插件：在不使用时禁用 EasyCode、MyBatisX 等
• 调整配置：降低 CodeGlance Pro 宽度，限制 Indent Rainbow 层级

通过合理配置这13个插件，您可以打造一个高效、稳定、美观的 Java 开发环境，显著提升开发效率和代码质量。