IntelliJ IDEA 初学者指南：从零创建并运行 Java 项目

前面发了很多篇博客，但是没具体的讲下如何使用idea并创建项目，那么这篇文章会带你加深理解

一、前期准备：IDEA 版本选择与 Java 环境配置

在创建 Java 项目前，需先解决"选对 IDEA 版本"和"搭好 Java 环境"两个关键问题，避免后续出现兼容性问题。

1. IDEA 版本选择：社区版足够满足新手需求

IDEA 分为社区版（Community Edition）和旗舰版（Ultimate Edition），针对 Java 初学者：

• 社区版：完全免费，原生支持 Java 开发（包括 Java SE、Java EE 基础功能），还能满足简单的 Maven、Gradle 项目需求，无任何功能限制，是新手的最佳选择。
• 旗舰版：付费（可申请学生免费授权），在社区版基础上增加了 Spring Boot、微服务、数据库可视化等企业级功能，适合后续进阶学习，但初学者暂用不到。

下载建议：直接前往 JetBrains 官网，选择"Community Edition"下载（以 Windows 系统为例，Mac、Linux 系统操作逻辑一致）。

2. Java 环境配置：安装 JDK 并配置环境变量

IDEA 运行 Java 项目依赖 JDK（Java Development Kit），需先安装并配置环境变量（以 JDK 17 为例，Java 8/11 也适用）：

1. 下载 JDK：打开 Oracle 官网 JDK 下载页，选择对应系统的 JDK 17 版本（需注册 Oracle 账号，或通过国内镜像站下载）。

2. 安装 JDK：双击安装包，选择安装路径（建议自定义路径，如 D:\Program Files\Java\jdk-17），一路点击"下一步"完成安装。

3. 配置环境变量（Windows）：

   • 右键"此电脑" > “属性” > “高级系统设置” > “环境变量”
   • 在"系统变量"中点击"新建"，变量名填 JAVA_HOME，变量值填 JDK 安装路径（如 D:\Program Files\Java\jdk-17）
   • 找到"Path"变量，点击"编辑"，新增两个路径：%JAVA_HOME%\bin 和 %JAVA_HOME%\jre\bin（若 JDK 17 无 jre 文件夹，可在终端执行 bin\jlink.exe --module-path jmods --add-modules java.desktop --output jre 生成）

4. 验证环境：打开 CMD 命令行，输入 java -version，若显示 java version "17.0.x"，说明环境配置成功。

二、IDEA 安装与初始化：新手快速上手

完成前期准备后，开始安装 IDEA 并进行基础设置，确保界面符合个人使用习惯。

1. IDEA 安装步骤（Windows）

双击下载的 IDEA 社区版安装包，进入安装向导：

1. 点击"Next"，选择安装路径（建议避开 C 盘，如 D:\Program Files\JetBrains\IntelliJ IDEA Community Edition 2025.1）
2. 勾选"64-bit launcher"（创建桌面快捷方式）、“Add launchers dir to PATH”（方便命令行调用）、“Associate .java files”（关联 Java 文件，双击即可用 IDEA 打开）
3. 点击"Install"，等待安装完成，最后点击"Finish"

2. 首次启动设置

• 首次打开提示"导入配置"，选择"Do not import settings"（新手无需导入）
• 选择 UI 主题：推荐"Darcula"深色主题（保护眼睛，代码高亮更清晰），也可选择"Light"浅色主题
• 后续步骤点击"Next"或"Skip"，完成初始化（无需安装额外插件，Java 支持已内置）

三、核心操作：用 IDEA 创建第一个 Java 项目

掌握"创建 Java 项目"是入门的核心，以下步骤从"新建项目"到"编写第一个 Java 类"，全程无遗漏，确保新手能跟上。

1. 新建 Java 项目（无框架基础版）

适合完全零基础的初学者，先掌握纯 Java 项目的创建逻辑：

1. 打开 IDEA，进入欢迎页，点击 New Project（新建项目）
2. 配置项目基础信息：
   • 左侧模板选择"Java"（IDEA 会自动识别已安装的 JDK）
   • 右侧"Project SDK"选择已配置的 JDK（如"17"，若显示""，点击"Add SDK"手动选择 JDK 安装路径）
   • 取消勾选"Add sample code"（暂时不添加示例代码，从零编写），点击"Next"
3. 设置项目名称与路径：
   • Name：项目名称（如"FirstJavaProject"，必须英文，避免中文乱码）
   • Location：项目保存路径（如 D:\IDEA_Projects\FirstJavaProject）
   • 取消勾选"Create Git repository"（暂时不用版本控制），点击"Create"

2. 认识 Java 项目结构（新手必懂）

项目创建完成后，左侧"Project"面板会显示标准 Java 项目结构，核心文件/文件夹功能如下：

名称	类型	功能说明
.idea	文件夹	IDEA 项目配置文件（自动生成，无需修改）
src	源代码文件夹	所有 Java 类文件（.java）都放在这里
FirstJavaProject.iml	文件	项目模块配置文件（自动生成，无需修改）

关键提醒：Java 代码必须放在 src 文件夹下，否则 IDEA 无法识别为可编译的源代码。

3. 创建第一个 Java 类并编写代码

Java 程序以"类"为基本单位，需先创建类文件才能编写代码：

1. 右键点击左侧 src 文件夹 > New > Java Class（新建 Java 类）
2. 输入类名（如"HelloWorld"，Java 类名必须首字母大写，遵循驼峰命名法），点击"Enter"
3. 编写第一个 Java 程序（打印"Hello, IDEA!"）：

public class HelloWorld {// 主方法：Java程序的入口，必须有这行代码才能运行public static void main(String[] args) {// 打印语句：在控制台输出内容System.out.println("Hello, IDEA!");}
}

代码说明：

• public class HelloWorld：定义公开类，类名与文件名必须一致
• public static void main(String[] args)：主方法，程序启动后会先执行这里的代码
• System.out.println(...)：控制台输出语句，括号内为要打印的内容

4. 运行 Java 程序（两种常用方式）

代码编写完成后，通过以下两种方式运行程序，查看结果：

方式 1：通过编辑区快捷按钮运行

• 在 HelloWorld.java 编辑区，找到主方法（main 方法）所在行的左侧，会出现一个绿色三角按钮（运行按钮）
• 点击绿色三角，选择"Run ‘HelloWorld.main()’"，IDEA 会自动编译并运行程序

方式 2：通过顶部工具栏运行

• 点击顶部工具栏的"Add Configuration"（下拉框），选择"Application"（应用程序）
• 配置运行参数：
  • Name：配置名称（如"HelloWorldRun"，自定义）
  • Main class：点击右侧"…",选择刚才创建的"HelloWorld"类
• 点击"OK"保存配置
• 点击顶部工具栏的绿色三角按钮（或按快捷键 Shift+F10），运行程序

5. 查看运行结果

程序运行后，底部会弹出"Run"控制台面板，若显示以下内容，说明运行成功：

Hello, IDEA!Process finished with exit code 0

"Process finished with exit code 0"表示程序无错误正常结束；若显示非 0 数字，则说明代码有错误，需根据控制台提示修改。

四、新手必备：IDEA Java 开发实用技巧

掌握以下技巧，能大幅提升 Java 代码编写效率，避免重复操作，减少错误。

1. 代码编辑技巧：让 IDEA 帮你"写代码"

• 自动补全：输入代码关键词时，IDEA 会弹出补全列表，按 Enter 或 Tab 确认（如输入"Sys"，会提示"System"；输入"main"，会提示补全主方法代码）
• 快速生成代码块：
  • 生成主方法：在类中输入 psvm，按 Enter，IDEA 会自动生成 public static void main(String[] args) {}
  • 生成打印语句：输入 sout，按 Enter，自动生成 System.out.println();（括号内可直接输入内容）
• 代码格式化：代码缩进混乱时，选中代码（或按 Ctrl+A 全选），按快捷键 Ctrl+Alt+L，IDEA 会自动调整缩进、空格，让代码整齐规范
• 注释代码：
  • 单行注释：选中代码行，按 Ctrl+/，会在代码前添加 //（再次按取消注释）
  • 多行注释：选中多行代码，按 Ctrl+Shift+/，会用 /* */ 包裹代码（再次按取消注释）

2. 错误排查技巧：新手如何快速找错

Java 代码报错时，IDEA 会用红色波浪线标注错误位置，新手可通过以下方式快速排查：

• 查看错误提示：将鼠标悬停在红色波浪线上，会显示错误原因（如"变量未定义"“括号不匹配”“语法错误”）
• 利用"Quick Fix"：错误位置左侧会出现黄色灯泡图标，点击图标，IDEA 会提供修复建议（如"创建变量"“导入包”），选择对应建议即可快速修复
• 查看控制台错误信息：若程序运行失败，底部"Run"面板会显示错误堆栈，找到"Caused by"后的内容，可定位具体错误行（如"Exception in thread “main” java.lang.Error: Unresolved compilation problem: …"，后面会标注错误行号）

3. 界面自定义：让 IDEA 更顺手

• 修改字体大小：默认字体较小时，通过 File > Settings > Editor > Font，修改"Size"为 14-16（根据屏幕分辨率调整），点击"OK"
• 显示行号：编辑区默认不显示行号，右键点击编辑区左侧空白处，勾选"Show Line Numbers"（或通过 Settings > Editor > General > Appearance，勾选"Show line numbers"）
• 自动保存：IDEA 默认开启自动保存，可通过 File > Settings > Appearance & Behavior > System Settings，确认"Save files on frame deactivation"（切换窗口时自动保存）和"Save files automatically if application is idle for X sec"（闲置时自动保存）已勾选

五、新手常见问题汇总：避坑指南

Java 初学者使用 IDEA 时，容易遇到以下问题，提前掌握解决方案，避免卡壳。

1. 问题：新建项目时"Project SDK"显示""

原因：IDEA 未识别到已安装的 JDK，或 JDK 环境变量配置错误

解决：

• 点击"“右侧的"Add SDK”，选择"JDK"
• 在弹出的窗口中，选择 JDK 安装路径（如 D:\Program Files\Java\jdk-17），点击"OK"
• 若仍无法识别，重新检查 JDK 环境变量配置（参考"Java 环境配置"步骤），并重启 IDEA

2. 问题：运行程序时提示"Error: Could not find or load main class HelloWorld"

原因：Java 类未放在 src 文件夹下，或类名与文件名不一致，导致 IDEA 无法找到主类

解决：

• 确认 .java 文件在 src 文件夹内（不在则剪切到 src 下）
• 确认类名与文件名完全一致（如类名是"HelloWorld"，文件名必须是"HelloWorld.java"，区分大小写）

3. 问题：代码无红色波浪线，但运行时提示"Exception in thread “main” java.lang.NullPointerException"

原因：空指针异常，通常是使用了未初始化的变量（如字符串、数组未赋值就调用方法）

解决：查看控制台错误行号，找到对应的变量，确保在使用前已赋值（如 String str = "test"; 而非 String str;）

4. 问题：IDEA 反应卡顿，代码提示变慢

原因：IDEA 正在构建项目索引（索引是实现代码提示的核心，首次打开项目或修改项目结构后会自动构建），或内存配置不足

解决：

• 等待索引构建完成（右下角会显示"Indexing…"，完成后消失）
• 若频繁卡顿，可通过 Help > Change Memory Settings，将"Maximum heap size"调整为 1024MB 或 2048MB（根据电脑内存配置，8GB 内存建议设为 2048MB），点击"Save and Restart"重启 IDEA

希望这篇文章能帮你快速上手 IDEA Java 开发。