在 IntelliJ IDEA 中创建第一个项目

1. 按步骤创建新项目

在 IntelliJ IDEA 中，项目不仅仅是一个包含文件的文件夹，而是一个容器，IDE 会在其中保存与你未来程序相关的一切。项目中包含：

• 源代码（扩展名为 .java 的文件）；
• 项目设置（例如要使用的 Java 版本）；
• 外部库（如果需要的话）；
• 辅助文件和资源。

在项目内部通常会有一个名为 src 的文件夹——这是存放 Java 源文件的主要位置。所有与代码无关的内容会单独存放，不会干扰开发。

启动 IntelliJ IDEA

在起始界面点击蓝色大按钮 New Project。

配置项目参数

我们从上到下看一下主要字段：

• Name: 你的项目名称。该名称也会用于在磁盘上创建对应的文件夹。
• Location: 项目在计算机上的存放路径。默认情况下 IDEA 会建议使用其自带的 IdeaProjects 文件夹。保持默认即可。
• Create Git repository: 允许为项目立即初始化 Git 版本控制系统。此阶段为避免复杂化，请保持不勾选。
• Build system: 构建系统——用于自动化编译代码、管理依赖并生成可运行应用程序的工具：
  • IntelliJ: IDEA 内置的构建系统。我们的选择。
  • Maven/Gradle: 强大的独立构建系统，99% 的真实项目都会使用其中之一。
• Add sample code: IDEA 会为我们自动创建项目的基础结构，并生成带有 main 方法的类。

在 IntelliJ IDEA 中安装 JDK

现在到了安装 JDK 的步骤。

• 由于尚未安装，列表会是空的。我们的任务是在此直接下载它。

1. 点击下拉列表，选择 Download JDK...

2. 会弹出一个小窗口：

• Version: 选择 Java 版本。本课程支持 25 版本。
• Vendor: 发行商。按照之前约定，选择 Amazon Corretto。
• Location: IDEA 下载并安装此 JDK 的路径。可保持默认值。

3. 点击 Select 按钮。

设置完成。点击 Create。

IntelliJ IDEA 将开始下载所选 JDK，之后会创建项目结构并打开编辑器主窗口。需要等待几分钟。

首次启动时，你可能会在右下角看到来自 IDEA 的通知，建议你配置杀毒软件，例如：“Microsoft Defender may affect IDE performance”。可以放心点击 Exclude folders。IntelliJ IDEA 会自动将你的项目文件夹及其系统文件夹添加到杀毒软件的排除列表中。

首次启动程序时，你会看到一个横幅通知，告知已激活 Ultimate 免费试用期。这是 IntelliJ IDEA 新统一版本中的标准欢迎信息。

此通知仅确认你现在拥有 Ultimate 的临时访问权限，但对于我们的课程来说，这是一个非必要的附加功能。

2. IDEA 简要概览

我们已经创建了新项目。来看一下界面上都有哪些内容。

1. Project 浏览项目结构的主窗口。

2. 当前打开的文件 Main.java

3. 运行（Run ▶）和调试（Debug）程序的按钮

4. 侧边菜单

• Services 选项卡用于管理外部服务，入门阶段用不到。
• Terminal 是你的操作系统（Windows、macOS、Linux）的命令行（控制台），直接内置在 IDE 中。
• Problems 面板会在你编写代码的过程中实时显示编译错误和警告。IDEA 会即时分析你的代码并标出问题位置，且常常提供自动修复建议。
• Git 分支状图标。该面板用于与 Git 版本控制系统交互。

3. 项目结构

现在更仔细地看看左侧的项目结构窗口。IntelliJ IDEA 为我们创建了几个重要的文件和文件夹。

• .idea —— IntelliJ IDEA 的内部配置文件夹。它保存该项目特有的设置。
  不要手动修改此文件夹，也不需要将它发送给其他开发者。它对每个用户都是独立的。
• src —— 任何 Java 项目中最重要的文件夹。名称是 “sources”（源码）的缩写。你的全部代码都会放在这里。
  • Main.java 由于我们勾选了 “Add sample code”，IDEA 为我们创建了这个文件。它是一个包含程序“入口点”的 Java 类——方法 public static void main(String[] args)。任何 Java 程序都从这里开始执行。
• .gitignore —— Git 版本控制系统的配置文件。
• External Libraries —— 这不是一个真实文件夹，而是项目所连接的所有外部库的虚拟展示。目前里面只有一个、但最重要的库——我们的 JDK。

4. 运行程序

最令人愉快的事情，就是运行程序并看到自己的成果（而不只是错误）。

在窗口顶部点击 Run 按钮 ▶。它左侧显示将要开始执行的文件名（本例为 Current File）：

另一种方式：在文件上右键 ▶ Run Run 'Main.main()'。

你将看到程序的执行结果

启动命令（红色）是 IntelliJ IDEA 生成并交给操作系统以启动程序的命令。

这是对我们下载的那个 JDK 中可执行文件 java.exe 的直接调用。正是该文件启动了 Java 虚拟机（JVM）。在 java.exe 之后的那一长串都是参数。

程序输出（蓝色）就是你的代码产生的有用结果。

退出码（绿色）Process finished with exit code 0。这条消息是对程序如何结束的最终报告。

• 按惯例，exit code 0 表示程序从头到尾成功执行并正常结束，没有任何错误。
• 任何其他代码都表示在执行过程中发生了错误。

始终留意这行信息。它是判断你的程序是“崩溃”还是正常结束的关键指标。

另外，在首次运行后，左侧的项目结构中会出现一个新的文件夹 out。其中存放编译生成的 .class 文件——也就是由 JVM 执行的字节码。

恭喜！你刚刚在专业的 IDE 中编写并运行了你的第一个 Java 程序。

IDEA 中程序运行的工作原理

当你点击 Run 时，会发生以下事情：

1. IDEA 编译你的代码——将 .java 转换为 .class（供 JVM 使用的字节码）。
2. 启动 JVM——Java 虚拟机从 main 方法开始执行程序。
3. 输出结果——所有通过 System.out.println 输出的内容都会显示在控制台。

这一切只需点几下鼠标——无需手动调用编译器或查找文件保存位置。

5. IntelliJ IDEA keyboard shortcuts

IntelliJ IDEA 为大多数与编辑、导航、重构、调试及其他任务相关的命令提供了快捷键。记住这些热键可以让你在不离开键盘的情况下更高效地工作。

你可以在 JetBrains 文档中查看快捷键，并可按操作系统进行选择。

也可以在 IDEA 内查看。Menu-Help-Keyboard shortcuts PDF。

6. 创建第一个项目时的常见错误

没有把 Java 文件放在 src 文件夹中

在 Java 世界里有一条铁律：src 文件夹是项目所有源码的根目录。开发环境和构建系统都期望在那里找到代码。

类名和文件名不一致
文件名必须与类名完全一致（区分大小写！）。例如，类 Main 的文件应为 Main.java。如果你将文件命名为 main.java（首字母小写），编译器会报错。

遗漏或错误书写 main 方法
方法必须严格是 public static void main(String[] args)。哪怕一个小小的拼写错误，程序也不会启动。

未为项目选择 JDK
如果在创建项目时没有选择 JDK，或路径选择错误，IDEA 将无法编译项目。请通过 File → Project Structure → Project SDK 检查设置。

路径中包含空格或西里尔字母
尽管现代系统已经宽容许多，但黄金法则依然有效：项目路径和 JDK 路径不应包含西里尔字母、空格或特殊符号。最好只使用拉丁字母和下划线。

运行了错误的类
如果你有多个包含 main 方法的类，请确认你运行的是正确的文件（右键 → ▶ Run）。