IntelliJ IDEA 开发配置教程

IntelliJ IDEA 开发配置教程

目录

• 1. 安装 IntelliJ IDEA
• 2. 首次启动配置
• 3. 基本设置配置
• 4. 开发环境配置
• 5. 插件配置
• 6. 代码样式配置
• 7. 版本控制配置
• 8. 构建工具配置
• 9. 调试配置
• 10. 性能优化

1. 安装 IntelliJ IDEA

1.1 下载

访问 JetBrains 官网 下载 IntelliJ IDEA：

• Community Edition（免费版）：适合 Java、Kotlin、Groovy、Scala 开发
• Ultimate Edition（付费版）：支持全栈开发，包括 Spring、Web 框架等

1.2 系统要求

系统	最低要求	推荐配置
内存	2 GB RAM	8 GB RAM
磁盘空间	2.5 GB	5 GB（含缓存）
分辨率	1024x768	1920x1080

1.3 安装步骤

Windows

# 1. 运行下载的 .exe 文件
# 2. 选择安装路径
# 3. 勾选以下选项：
#    - 64-bit launcher
#    - Add launchers dir to PATH
#    - .java association
#    - .kt association

macOS

# 1. 打开下载的 .dmg 文件
# 2. 将 IntelliJ IDEA 拖拽到 Applications 文件夹

Linux

# 1. 解压下载的 tar.gz 文件
tar -xzf ideaIU-*.tar.gz# 2. 移动到 /opt 目录
sudo mv idea-IU-* /opt/intellij-idea# 3. 创建桌面快捷方式
sudo ln -s /opt/intellij-idea/bin/idea.sh /usr/local/bin/idea

2. 首次启动配置

2.1 导入设置

首次启动时，IDEA 会询问是否导入之前的设置：

Do not import settings （推荐新用户）
Import settings from a previous version
Import settings from a config folder or file

2.2 选择UI主题

Light - 浅色主题
Darcula - 深色主题（推荐）
High contrast - 高对比度主题

2.3 创建桌面快捷方式

勾选 “Create Desktop Entry” 创建桌面快捷方式。

2.4 设置插件

选择需要的插件集合或跳过此步骤后续再配置。

3. 基本设置配置

3.1 打开设置

Windows/Linux: File → Settings (Ctrl+Alt+S)
macOS: IntelliJ IDEA → Preferences (⌘+,)

3.2 外观设置

3.2.1 主题配置

Settings → Appearance & Behavior → Appearance
Theme: Darcula（推荐）或 IntelliJ Light

3.2.2 字体配置

Settings → Appearance & Behavior → Appearance
- Use custom font: 启用
- Font: JetBrains Mono（推荐）或 Consolas
- Size: 14（根据屏幕调整）

3.2.3 工具栏配置

Settings → Appearance & Behavior → Appearance
- Show tool window bars: ✓
- Show memory indicator: ✓（显示内存使用情况）

3.3 编辑器设置

3.3.1 字体配置

Settings → Editor → Font
- Font: JetBrains Mono
- Size: 14
- Line height: 1.2
- Enable ligatures: ✓（启用连字）

3.3.2 颜色方案

Settings → Editor → Color Scheme
推荐方案：
- Darcula（默认深色）
- IntelliJ Light（浅色）
- One Dark theme（需要安装插件）

3.3.3 代码折叠

Settings → Editor → General → Code Folding
- File header: ✓
- Imports: ✓
- Generic constructor and method parameters: ✓

4. 开发环境配置

4.1 JDK 配置

4.1.1 添加 JDK

Settings → Build, Execution, Deployment → Build Tools → Gradle/Maven
或
File → Project Structure → SDKs → + → Add JDK

4.1.2 设置项目 JDK

File → Project Structure → Project
- Project SDK: 选择已安装的 JDK
- Project language level: 根据 JDK 版本选择

4.2 编码设置

Settings → Editor → File Encodings
- Global Encoding: UTF-8
- Project Encoding: UTF-8
- Default encoding for properties files: UTF-8
- Transparent native-to-ascii conversion: ✓

4.3 换行符设置

Settings → Editor → Code Style
- Line separator: Unix and macOS (\n) 推荐

5. 插件配置

5.1 安装插件

Settings → Plugins → Marketplace

5.2 推荐插件列表

5.2.1 代码质量和格式化

- SonarLint - 代码质量检查
- CheckStyle-IDEA - Java 代码规范检查
- SpotBugs - 静态代码分析
- Save Actions - 保存时自动格式化

5.2.2 版本控制

- GitToolBox - Git 增强工具
- Git Flow Integration - Git Flow 支持
- GitHub Copilot - AI 代码助手（付费）

5.2.3 开发效率

- Key Promoter X - 快捷键提示
- Rainbow Brackets - 彩虹括号
- Indent Rainbow - 缩进彩虹
- String Manipulation - 字符串操作工具
- Translation - 翻译插件

5.2.4 框架支持

- Spring Boot Helper - Spring Boot 开发助手
- MyBatis X - MyBatis 增强插件
- Lombok - Lombok 支持
- Maven Helper - Maven 依赖分析

5.2.5 前端开发

- Vue.js - Vue 支持
- JavaScript and TypeScript - JS/TS 支持
- CSS Support - CSS 增强

5.3 插件配置示例

5.3.1 Save Actions 配置

Settings → Other Settings → Save Actions
- Activate save actions on save: ✓
- Optimize imports: ✓
- Reformat file: ✓
- Rearrange fields and methods: ✓

5.3.2 Rainbow Brackets 配置

Settings → Other Settings → Rainbow Brackets
- Enable rainbow brackets: ✓
- Do NOT rainbow angle brackets: ✓

6. 代码样式配置

6.1 Java 代码样式

Settings → Editor → Code Style → Java

6.1.1 缩进设置

Tabs and Indents:
- Use tab character: ✗（使用空格）
- Tab size: 4
- Indent: 4
- Continuation indent: 8

6.1.2 空格设置

Spaces:
- Before parentheses:- Method declaration parentheses: ✗- Method call parentheses: ✗- if parentheses: ✓- for parentheses: ✓- while parentheses: ✓

6.1.3 换行设置

Wrapping and Braces:
- Keep when reformatting:- Line breaks: ✓- Simple blocks in one line: ✗
- Braces placement:- Class declaration: End of line- Method declaration: End of line- Other: End of line

6.2 导入设置

Settings → Editor → Code Style → Java → Imports
- Class count to use import with '*': 5
- Names count to use static import with '*': 3
- Import layout:import static all other imports<blank line>import java.*import javax.*<blank line>import all other imports

6.3 XML 代码样式

Settings → Editor → Code Style → XML
Tabs and Indents:
- Tab size: 2
- Indent: 2
- Continuation indent: 4

7. 版本控制配置

7.1 Git 配置

7.1.1 Git 可执行文件

Settings → Version Control → Git
- Path to Git executable: 配置 Git 路径
- Use credential helper: ✓

7.1.2 Git 用户信息

# 在终端中配置（全局设置）
git config --global user.name "Your Name"
git config --global user.email "[e-mail]"

7.1.3 GitHub 集成

Settings → Version Control → GitHub
- Add account → Login with Token
- 输入 GitHub Personal Access Token

7.2 版本控制显示设置

Settings → Version Control
- Show directories with changed descendants: ✓
- Highlight directories that contain modified files in Project tree: ✓Settings → Version Control → Commit
- Use non-modal commit interface: ✓（推荐）

7.3 .gitignore 配置

在项目根目录创建 .gitignore 文件：

# IDEA
.idea/
*.iml
*.iws
*.ipr
out/
target/# Java
*.class
*.jar
*.war
*.ear# Logs
*.log# OS
.DS_Store
Thumbs.db# Temporary files
*.tmp
*.temp
*~

8. 构建工具配置

8.1 Maven 配置

8.1.1 Maven 设置

Settings → Build, Execution, Deployment → Build Tools → Maven
- Maven home directory: 选择 Maven 安装路径
- User settings file: 选择 settings.xml 文件路径
- Local repository: 设置本地仓库路径

8.1.2 Maven 导入设置

Settings → Build, Execution, Deployment → Build Tools → Maven → Importing
- Import Maven projects automatically: ✓
- Automatically download: Sources ✓ Documentation ✓
- VM options for importer: -Xmx1024m

8.1.3 Maven Runner 设置

Settings → Build, Execution, Deployment → Build Tools → Maven → Runner
- VM Options: -DarchetypeCatalog=internal
- Skip tests: ✗（不要默认跳过测试）

8.2 Gradle 配置

Settings → Build, Execution, Deployment → Build Tools → Gradle
- Use Gradle from: 'gradle-wrapper.properties' file
- Gradle JVM: 选择项目 JDK
- Build and run using: IntelliJ IDEA（推荐）
- Run tests using: IntelliJ IDEA（推荐）

8.3 编译设置

Settings → Build, Execution, Deployment → Compiler
- Build project automatically: ✓
- Compile independent modules in parallel: ✓
- User-local build process heap size (Mbytes): 2048

9. 调试配置

9.1 调试器设置

Settings → Build, Execution, Deployment → Debugger
- Remove unreachable breakpoints during debugging session: ✓
- Evaluate finally blocks: ✓

9.2 Run/Debug 配置

9.2.1 创建运行配置

Run → Edit Configurations → + → Application
- Name: 应用名称
- Main class: 主类全限定名
- Program arguments: 程序参数
- VM options: JVM 参数（如 -Xmx1g）
- Working directory: 工作目录

9.2.2 常用 JVM 参数

-Xms512m          # 初始堆大小
-Xmx1g            # 最大堆大小
-XX:+UseG1GC      # 使用 G1 垃圾收集器
-Dfile.encoding=UTF-8  # 文件编码
-Dspring.profiles.active=dev  # Spring 激活配置文件

9.3 断点设置

- 行断点: 点击行号左侧
- 条件断点: 右键断点设置条件
- 异常断点: Run → View Breakpoints → + → Java Exception Breakpoints

10. 性能优化

10.1 内存设置

10.1.1 IDEA 内存配置

Help → Change Memory Settings
推荐设置：
- 8GB RAM: 2048 MB
- 16GB RAM: 4096 MB
- 32GB RAM: 8192 MB

10.1.2 自定义 VM 选项

创建 idea64.exe.vmoptions 文件（Windows）或对应平台文件：

-Xms2048m
-Xmx4096m
-XX:ReservedCodeCacheSize=1024m
-XX:+UseConcMarkSweepGC
-XX:SoftRefLRUPolicyMSPerMB=50
-ea
-XX:CICompilerCount=2
-Dsun.io.useCanonicalPrefixCache=false
-Djdk.http.auth.tunneling.disabledSchemes=""
-XX:+HeapDumpOnOutOfMemoryError
-XX:-OmitStackTraceInFastThrow
-Djb.vmOptionsFile=%IDE_HOME%\bin\idea64.exe.vmoptions

10.2 索引和缓存

10.2.1 排除文件和目录

Settings → Editor → File Types → Ignored Files and Folders
添加不需要索引的目录：
- node_modules
- .git
- target
- build
- out

10.2.2 清理缓存

File → Invalidate Caches and Restart
定期清理可以解决各种奇怪问题

10.3 编辑器优化

Settings → Editor → General
- Strip trailing spaces on Save: Modified Lines
- Ensure line feed at file end on Save: ✓
- Show whitespaces: Leading ✓Settings → Editor → General → Appearance  
- Show line numbers: ✓
- Show method separators: ✓
- Show whitespaces: ✓

11. 快捷键配置

11.1 设置快捷键方案

Settings → Keymap
选择快捷键方案：
- IntelliJ IDEA Classic
- Eclipse（适合 Eclipse 用户）
- VS Code（适合 VS Code 用户）
- macOS（macOS 用户）

11.2 常用快捷键

功能	Windows/Linux	macOS
搜索所有	Ctrl + Shift + A	⌘ + Shift + A
查找文件	Ctrl + Shift + N	⌘ + Shift + O
查找类	Ctrl + N	⌘ + O
最近文件	Ctrl + E	⌘ + E
运行	Shift + F10	^ + R
调试	Shift + F9	^ + D
重构重命名	Shift + F6	Shift + F6
格式化代码	Ctrl + Alt + L	⌘ + Alt + L
优化导入	Ctrl + Alt + O	^ + Alt + O

11.3 自定义快捷键

Settings → Keymap → 搜索功能名称 → 右键 → Add Keyboard Shortcut
推荐自定义：
- Terminal: Alt + T
- Bookmarks: F11
- Show in Explorer: Ctrl + Alt + F12

12. 项目配置模板

12.1 创建项目模板

File → New Projects Setup → Structure for New Projects
配置新项目的默认结构、SDK、依赖等

12.2 代码模板

12.2.1 Live Templates

Settings → Editor → Live Templates
创建常用代码模板：
- psvm: public static void main
- sout: System.out.println
- fori: for loop with iterator

12.2.2 文件模板

Settings → Editor → File and Code Templates
配置新建文件的默认模板，包含：
- 版权信息
- 作者信息
- 创建时间

12.3 代码检查配置

Settings → Editor → Inspections
- 启用所有 Java 相关检查
- 设置警告级别：- Error: 语法错误- Warning: 代码问题  - Weak Warning: 代码风格

13. 数据库工具配置（Ultimate版）

13.1 数据库连接

View → Tool Windows → Database
点击 + 添加数据源：
- MySQL
- PostgreSQL  
- H2
- SQLite
等

13.2 数据库配置示例

MySQL 连接配置：
- Host: localhost
- Port: 3306
- Database: your_database
- User: your_username
- Password: your_password
- Driver: MySQL Connector/J

14. Web 开发配置（Ultimate版）

14.1 服务器配置

Settings → Build, Execution, Deployment → Application Servers
添加应用服务器：
- Tomcat
- JBoss
- WebLogic

14.2 Spring Boot 配置

创建 Spring Boot 项目：
File → New → Project → Spring Initializr
- 选择依赖
- 配置包名
- 选择 Java 版本

15. 导出和备份配置

15.1 导出设置

File → Manage IDE Settings → Export Settings
选择要导出的配置：
- Code style schemes
- Color schemes  
- Keymap
- Live templates
- File templates

15.2 同步设置

File → Manage IDE Settings → Settings Repository
使用 Git 仓库同步设置到多台机器

16. 故障排除

16.1 常见问题

16.1.1 IDEA 启动慢

解决方案：
1. 增加内存分配
2. 排除不必要的目录
3. 禁用不需要的插件
4. 清理缓存

16.1.2 索引问题

解决方案：
1. File → Invalidate Caches and Restart
2. 删除 .idea 目录重新导入项目
3. 检查防病毒软件是否干扰

16.1.3 编码问题

解决方案：
1. 统一设置 UTF-8 编码
2. 检查 JVM 启动参数 -Dfile.encoding=UTF-8
3. 检查操作系统区域设置

16.2 日志查看

Help → Show Log in Explorer/Finder
查看 idea.log 文件排查问题

17. 进阶配置

17.1 自定义配色方案

Settings → Editor → Color Scheme → General
可以自定义：
- 关键字颜色
- 字符串颜色
- 注释颜色
- 背景颜色

17.2 代码生成

Settings → Editor → General → Postfix Completion
启用后缀补全：
- .var: 生成变量声明
- .null: 空判断
- .nn: 非空判断

17.3 重构设置

Settings → Editor → General → Refactorings
- Rename in comments and strings: ✓
- Rename variables in comments and strings: ✓

总结

通过以上详细配置，您可以打造一个高效、舒适的 IntelliJ IDEA 开发环境。记住以下几个要点：

1. 个性化设置：根据个人习惯调整主题、字体、快捷键
2. 项目需求：根据项目类型安装相应插件和配置
3. 性能优化：合理分配内存，排除无关目录
4. 备份设置：定期导出配置，便于在不同机器间同步
5. 持续优化：随着使用经验积累，不断调整和优化配置

配置完成后，建议花时间熟悉各种功能和快捷键，这将大大提升您的开发效率。