IntelliJ IDEA 入门指南：从零创建并运行 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 项目结构，核心文件/文件夹功能如下：

关键提醒：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