IntelliJ IDEA 2025.2 Help

使用 IntelliJ IDEA 编译和构建应用程序

IntelliJ IDEA 编译和构建过程编译源文件,并结合外部库、属性文件和配置,生成一个有效的应用程序。 IntelliJ IDEA 使用的编译器遵循 Java 规范。

您可以编译单个文件,使用增量构建编译模块或项目,并从头开始重新构建项目。

如果您有一个纯 Java 或 Kotlin 项目,我们建议您使用 IntelliJ IDEA 来构建您的项目,因为 IntelliJ IDEA 支持增量构建,这显著加快了构建过程。

然而,如果构建脚本文件使用自定义插件或任务,IntelliJ IDEA 原生构建器可能无法正确构建 Gradle 或 Maven 项目。 在这种情况下,委托给 GradleMaven 的构建可以帮助您正确构建项目。

编译单个文件或类

  • 在编辑器中打开所需的文件并进入主菜单中的 构建 | 重新编译“class name” (Ctrl+Shift+F9)。

    或者,在 项目 工具窗口中,右键点击您需要的类,然后从上下文菜单中选择 重新编译“class name”

    如果在编译过程中发生错误, IntelliJ IDEA 将会在 审核编译和构建输出 中显示这些错误以及警告信息。

更改编译输出位置

当您编译源代码时,IntelliJ IDEA 会自动创建一个包含已编译 .类 文件的输出目录。

编译输出目录

在输出目录中,IntelliJ IDEA 还会为您的每个模块创建子目录。

默认子目录路径如下:

  • 源: <ProjectFolder>/out/production/<ModuleName>

  • 测试: <ProjectFolder>/out/test/<ModuleName>

在项目级别,您可以更改输出路径的 <ProjectFolder>/out 部分。 如果您这样做(比如,指定一些 <OutputFolder> 而不是 <ProjectFolder>/out ),但不在模块级别重新定义路径,编译结果将会去 <OutputFolder>/production/<ModuleName> <OutputFolder>/test/<ModuleName>

在模块级别,您可以为模块源代码和测试分别指定任何理想的编译输出位置。

指定编译输出文件夹

  1. 打开 项目结构 对话框 (文件 | 项目结构 Ctrl+Alt+Shift+S)。

  2. 项目设置 中,选择 项目 并在 项目编译器输出 字段中指定相应的路径。

    项目结构对话框 / 项目页面

    对于模块,请选择 模块 ,您需要的模块以及 路径 选项卡。 在 编译器输出 部分更改输出文件夹的位置。

    项目结构对话框 / 模块页面

构建

当您执行 构建 构建项目图标 命令时,IntelliJ IDEA 会编译构建目标内的所有类,并将它们放置在输出目录中。

当您更改构建目标内的任何类然后执行构建操作时,IntelliJ IDEA 会执行增量构建,只编译更改的类。 IntelliJ IDEA 还会递归构建类的依赖关系。

构建模块或项目

  • 选择您想要编译的模块或项目,然后转到 构建 | 构建项目 (Ctrl+F9)。

    IntelliJ IDEA 在 审核编译和构建输出 中显示编译结果。

如果您将模块依赖项添加到主模块并构建该模块,IntelliJ IDEA 也会构建依赖模块,并将其与主模块一起显示在输出目录中。 如果依赖模块有自己的模块依赖,那么 IntelliJ IDEA 将从最少依赖的模块开始递归编译所有依赖。

项目结构对话框 / 模块页面

模块依赖项的排序方式对于编译成功非常重要。 如果任何两个 JAR 文件包含相同名称的类,IntelliJ IDEA 编译器将使用其在类路径中首先找到的 JAR 文件中的类。

有关更多信息,请参见 模块依赖项

重新构建

当您执行重建命令时,IntelliJ IDEA 会清空整个输出目录,删除构建缓存并从头开始构建项目或模块。 当 classpath 条目发生更改时,这可能会有所帮助。 例如,项目使用的 SDK 或库被添加、删除或更改。

重新构建模块或项目

  • 在主菜单中,前往 构建 | 重新构建项目 查找整个项目或 构建 | 重建“module name” 查找模块重建。

    IntelliJ IDEA 在 审核编译和构建输出 中显示构建结果。

后台编译(自动构建)

您可以配置 IntelliJ IDEA,使其在每次更改项目时自动构建您的项目。 背景编译的结果显示在 Problems 工具窗口中。

配置后台编译

  1. Ctrl+Alt+S 打开设置,然后选择 生成、执行、部署 | 编译器

  2. 编译器 页面上,选择 自动构建项目

    现在,当您在类文件中进行更改时,IntelliJ IDEA 会自动执行项目的增量构建。

    自动构建也会在您保存文件(Ctrl+S )时触发,或当您在 系统设置对话框中选择了 如果应用程序空闲 N 秒,则自动保存文件。 选项时触发。

运行前编译

默认情况下,当您运行应用程序时,IntelliJ IDEA 会编译您尝试运行的类所在的模块。

如果您想更改此行为,您可以在 Run/Debug Configurations 对话框中进行更改。

配置运行/调试配置

  1. 在主菜单中,前往 运行 | 编辑配置

  2. 在打开的对话框中,创建一个新的运行配置或打开一个现有的运行配置。

  3. 请点击 修改选项 链接。

  4. 添加运行选项 列表中,在 启动前 部分下,选择 添加启动前任务。 任务列表将变得可用,并且 构建 将被选中。 点击 关闭图标 以禁用它。

    运行/调试配置对话框:启动前
  5. 如果您需要添加一个新的配置操作,请点击 "添加"按钮 ,并从打开的列表中选择所需的选项。

    例如, 如果您选择 构建项目 ,那么 IntelliJ IDEA 将在运行之前构建整个项目。 在这种情况下,没有包含在 构建 操作中的依赖项将会被考虑在内。 如果您选择 构建,不检查错误 选项,IntelliJ IDEA 将在编译结果有错误的情况下运行应用程序。

    运行/调试配置:添加新配置。

审核编译和构建输出

IntelliJ IDEA 会报告编译及构建结果,这些结果会显示在 Build tool window中,显示有关错误和警告的消息以及成功的编译步骤。

IntelliJ IDEA 构建输出

如果您配置了 auto-build ,则 IntelliJ IDEA 使用问题工具窗口显示消息。 即使构建成功执行,该窗口也可用。 要打开它,请点击状态栏上的 自动构建

Problems 工具窗口

双击消息以跳转到源代码中的问题。 如果您需要调整 编译器设置 ,请点击 编译器属性图标

将应用程序打包成 JAR

当代码编译完成后,您可以将应用程序打包成 Java 存档 (JAR),以便与其他开发者共享。 构建的 Java 存档称为 artifact

为 JAR 创建工件配置

  1. 在主菜单中,转到 文件 | 项目结构 Ctrl+Alt+Shift+S 并点击 工件

  2. 请点击 "添加"按钮 ,指向 JAR ,然后选择 从依赖关系模块

  3. 主类 字段的右侧,点击 浏览按钮 并在打开的对话框中选择主类(例如, HelloWorld(com.example.helloworld))。

    IntelliJ IDEA 创建工件配置,并显示其在 项目结构 对话框右侧的设置。

  4. 应用更改并关闭对话框。

创建工件配置

构建 JAR 工件

  1. 在主菜单中,前往 构建 | 构建工件

  2. 指向已创建的 .jar HelloWorld:jar )并选择 构建

    如果您现在查看 out/artifacts 文件夹,您会在那里找到您的 .jar 文件。

JAR 工件已构建

当您构建一个项目时,存储在 Resources root中的资源会默认复制到编译输出文件夹中。 如有必要,您可以在输出文件夹中 指定另一个目录来放置资源。

将其他文件添加到 JAR 工件

您可以将其他文件添加到 JAR artifact。 例如,您可以添加一些图像文件、配置文件和 JAR 文件。

将文件添加到JAR工件

  1. 在主菜单中,转到 文件 | 项目结构 Ctrl+Alt+Shift+S 并点击 工件

  2. 输出布局 下,点击 添加副本

  3. 从上下文菜单中选择 文件

  4. 在打开的对话框中,找到该文件,添加并点击 OK

  5. 在主菜单中,前往 构建 | 构建工件

  6. 指向创建的 .jar 并选择 构建

    构建的 JAR 工件包含添加的文件。

运行已打包的 JAR

IntelliJ IDEA 允许您创建专用的运行配置,以便运行打包在 JAR 中的 Java 应用程序。

创建运行配置

  1. Ctrl+Shift+A ,查找并运行 编辑配置 操作。

  2. 运行/调试配置 对话框中,点击 "添加"按钮 并选择 JAR 应用程序

  3. 为新的配置添加一个名称。

    创建新的运行配置
  4. JAR 路径 字段中,点击 浏览按钮 并指定您计算机上 JAR 文件的路径。

  5. 启动前 下,点击 "添加"按钮 ,在打开的对话框中选择 构建物

    这意味着每次执行运行配置时,JAR 都会自动构建。

运行配置允许您定义如何运行应用程序,包括使用哪些参数和选项。 您可以为同一个应用程序拥有多个运行配置,每个配置都有其自己的设置。

执行运行配置

  • 在工具栏上,选择创建的配置,然后点击运行配置选择器右侧的 运行按钮。 另一种方法是,按 Shift+F10 如果您更喜欢快捷键。

    与之前一样, 运行 工具窗口会打开,并显示应用程序输出。

运行打包应用程序

如果进程已成功退出,则应用程序已正确打包。

最后修改日期: 2025年 9月 22日