# 教程：JUnit 入门

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

在本教程中，您将学习如何为您的项目设置 JUnit，创建测试并运行它们以查看您的代码是否正确运行。 它只包含使您入门的基本步骤。

如果您想了解更多关于 JUnit 的信息，请参考 [官方文档](https://junit.org/junit5/)。 要了解有关 IntelliJ IDEA 测试功能的更多信息，请参阅本节中的其他主题。

您可以选择使用 Maven、Gradle 或 IntelliJ builder 来完成本教程。

Maven:

Procedure: 创建项目

1. 打开   新建项目  向导：

* 如果位于主屏幕，请选择 `![加号](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.general.add.svg) 新建 | ![文件夹图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.nodes.folder.svg) 项目……` 。

* 如果已打开另一个项目，请转到 `文件 | 新建 | 项目` 。

2. 在向导左侧，选择 ![Java 徽标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.fileTypes.java.svg)   Java  。

3. 为项目指定名称，例如  `junit-tutorial` ，并选择   Maven   作为构建工具。

4. 从    JDK    列表中选择您想在项目中使用的 [JDK](sdk.html#jdk)。

* 如果已在计算机上安装 JDK，但未在 IDE 中定义，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.nodes.jdk.png) 从磁盘添加 JDK… 并指定 JDK 主目录的路径。​

* 如果您的计算机上没有必要的 JDK，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.download.svg) 下载 JDK 。

5. 点击   创建  。

> **Tip:**
> 有关使用 Maven 项目的更多信息，请参阅 [Maven](maven-support.html)。

Procedure: 添加依赖项

要让项目使用 JUnit 功能，需要将 JUnit 添加为依赖项。

1. 在项目根目录中打开  `pom.xml` 。

> **Tip:**
> 若要快速定位到某个文件，请按 `Ctrl+Shift+N` (Windows), `⌘ ⇧ O` (macOS), `⌘ ⇧ N` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ O` (macOS System Shortcuts), `Ctrl+Shift+N` (XWin), `Ctrl+Shift+N` (GNOME), `Ctrl+Shift+N` (KDE), `Ctrl+X, Ctrl+F` (Emacs), `Ctrl+P` (Sublime Text), `⌘ P` (Sublime Text (macOS)), `Ctrl+Shift+T` (Visual Studio), `⌘ ⇧ T` (Visual Studio (macOS)), `Alt+Shift+O` (NetBeans), `Ctrl+Shift+R` (Eclipse), `⌘ ⇧ R` (Eclipse (macOS)) 并输入其名称。

2. 在  `pom.xml`  中，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 并选择   依赖  。

3. 在打开的对话框中，在搜索字段中输入  `org.junit.jupiter:junit-jupiter` 。

在搜索结果中找到所需的依赖项，然后点击   添加  。

4. 将依赖项添加到  `pom.xml`  后，按 `Ctrl+Shift+O` (Windows), `Ctrl+Shift+O` (macOS), `Ctrl+Shift+O` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift+O` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `Ctrl+Shift+O` (Sublime Text (macOS)), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS))，或在   Maven   工具窗口中点击 ![重新导入所有 Maven 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.refresh.svg) 以导入更改。

![Sync Maven Changes 按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/junit-tutorial-maven-reload.png)

添加依赖项后，您的  `pom.xml`  文件将类似于以下内容：

```XML
<?xml version="1.0" encoding="UTF-8"?>
  <project xmlns="http://maven.apache.org/POM/4.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
      <modelVersion>4.0.0</modelVersion>

      <groupId>org.example</groupId>
      <artifactId>junit-tutorial</artifactId>
      <version>1.0-SNAPSHOT</version>

      <properties>
          <maven.compiler.source>21</maven.compiler.source>
          <maven.compiler.target>21</maven.compiler.target>
          <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      </properties>
      <dependencies>
          <dependency>
              <groupId>org.junit.jupiter</groupId>
              <artifactId>junit-jupiter-engine</artifactId>
              <version>5.7.0</version>
          </dependency>
      </dependencies>
  </project>


```

> **Tip:**
> 上述过程展示了手动方式，便于您了解幕后发生了什么，以及在何处设置测试框架。 然而，如果您刚开始编写测试，IntelliJ IDEA [会自动检测依赖是否丢失并提示您添加它](testing.html#add-testing-libraries)。

Procedure: 编写应用程序代码

让我们添加一些我们将要测试的代码。

1. 在   项目   工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 中，右键点击  `src/main/java`  文件夹并选择  `新建 | Java 类` 。 将该类命名为  `Calculator.java` 。

2. 请将以下代码粘贴到文件中：

```JAVA
import java.util.stream.DoubleStream;

public class Calculator {

    static double add(double... operands) {
        return DoubleStream.of(operands)
                .sum();
    }

    static double multiply(double... operands) {
        return DoubleStream.of(operands)
                .reduce(1, (a, b) -> a * b);
    }
}

```

Gradle:

Procedure: 创建项目

1. 打开   新建项目  向导：

* 如果位于主屏幕，请选择 `![加号](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.general.add.svg) 新建 | ![文件夹图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.nodes.folder.svg) 项目……` 。

* 如果已打开另一个项目，请转到 `文件 | 新建 | 项目` 。

2. 在向导左侧，选择 ![Java 徽标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.fileTypes.java.svg)   Java  。

3. 为项目指定名称，例如  `junit-tutorial` ，并选择   Gradle   作为构建工具。

4. 从    JDK    列表中选择您想在项目中使用的 [JDK](sdk.html#jdk)。

* 如果已在计算机上安装 JDK，但未在 IDE 中定义，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.nodes.jdk.png) 从磁盘添加 JDK… 并指定 JDK 主目录的路径。​

* 如果您的计算机上没有必要的 JDK，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.download.svg) 下载 JDK 。

5. 点击   创建  。

> **Tip:**
> 有关使用 Gradle 项目的更多信息，请参阅 [Gradle](gradle.html)。

Procedure: 添加依赖项

新建的 Gradle 项目通常默认包含最新的 JUnit 依赖项。 如果缺少该依赖项，可以手动将 JUnit 添加为依赖项。

1. 在项目根目录中打开  `build.gradle` 。

> **Tip:**
> 若要快速定位到某个文件，请按 `Ctrl+Shift+N` (Windows), `⌘ ⇧ O` (macOS), `⌘ ⇧ N` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ O` (macOS System Shortcuts), `Ctrl+Shift+N` (XWin), `Ctrl+Shift+N` (GNOME), `Ctrl+Shift+N` (KDE), `Ctrl+X, Ctrl+F` (Emacs), `Ctrl+P` (Sublime Text), `⌘ P` (Sublime Text (macOS)), `Ctrl+Shift+T` (Visual Studio), `⌘ ⇧ T` (Visual Studio (macOS)), `Alt+Shift+O` (NetBeans), `Ctrl+Shift+R` (Eclipse), `⌘ ⇧ R` (Eclipse (macOS)) 并输入其名称。

2. 在  `build.gradle`  中，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Alt+Insert` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) 并选择   添加 Maven 工件依赖  。

3. 在打开的工具窗口中，在搜索字段中输入  `org.junit.jupiter:junit-jupiter` 。

在搜索结果中找到所需的依赖项，然后点击   添加  。

4. 将依赖项添加到  `build.gradle`  后，按 `Ctrl+Shift+O` (Windows), `Ctrl+Shift+O` (macOS), `Ctrl+Shift+O` (IntelliJ IDEA Classic (macOS)), `Ctrl+Shift+O` (macOS System Shortcuts), `Ctrl+Shift+O` (XWin), `Ctrl+Shift+O` (GNOME), `Ctrl+Shift+O` (KDE), `Ctrl+Shift+O` (Emacs), `Ctrl+Shift+O` (Sublime Text), `Ctrl+Shift+O` (Sublime Text (macOS)), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (NetBeans), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS))，或在   Gradle   工具窗口中点击 ![重新导入所有 Gradle 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.refresh.svg) 以导入更改。

> **Tip:**
> 上述过程展示了手动方式，便于您了解幕后发生了什么，以及在何处设置测试框架。 然而，如果您刚开始编写测试，IntelliJ IDEA [会自动检测依赖是否丢失并提示您添加它](testing.html#add-testing-libraries)。

Procedure: 编写应用程序代码

让我们添加一些我们将要测试的代码。

1. 在   项目   工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 中，右键点击  `src/main/java`  文件夹并选择  `新建 | Java 类` 。 将该类命名为  `Calculator.java` 。

2. 请将以下代码粘贴到文件中：

```JAVA
import java.util.stream.DoubleStream;

public class Calculator {

    static double add(double... operands) {
        return DoubleStream.of(operands)
                .sum();
    }

    static double multiply(double... operands) {
        return DoubleStream.of(operands)
                .reduce(1, (a, b) -> a * b);
    }
}

```

IntelliJ 构建工具:

Procedure: 创建项目

1. 打开   新建项目  向导：

* 如果位于主屏幕，请选择 `![加号](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.general.add.svg) 新建 | ![文件夹图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.nodes.folder.svg) 项目……` 。

* 如果已打开另一个项目，请转到 `文件 | 新建 | 项目` 。

2. 在向导左侧，选择 ![Java 徽标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/intellij.platform.icons.expui.fileTypes.java.svg)   Java  。

3. 为项目指定名称，例如  `junit-tutorial` ，并选择   IntelliJ   作为构建工具。

4. 从    JDK    列表中选择您想在项目中使用的 [JDK](sdk.html#jdk)。

* 如果已在计算机上安装 JDK，但未在 IDE 中定义，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.nodes.jdk.png) 从磁盘添加 JDK… 并指定 JDK 主目录的路径。​

* 如果您的计算机上没有必要的 JDK，请选择 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.download.svg) 下载 JDK 。

5. 点击   创建  。

Procedure: 添加依赖项

要让项目使用 JUnit 功能，需要将 JUnit 添加为依赖项。

1. 在主菜单中，转到  `文件 | 项目结构` （ `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))）。

2. 在   项目设置   下，选择   库   并点击 ![新建项目库按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  `| 来源于 Maven` 。

3. 在打开的对话框中，指定必要的库 artifact，例如：  `org.junit.jupiter:junit-jupiter:5.9.1`  。

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

![手动添加测试库到项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/add-testlib-manually.png)

> **Tip:**
> 上述过程展示了手动方式，便于您了解幕后发生了什么，以及在何处设置测试框架。 然而，如果您刚开始编写测试，IntelliJ IDEA [会自动检测依赖是否丢失并提示您添加它](testing.html#add-testing-libraries)。

Procedure: 为测试创建文件夹

1. 在   项目   工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 中，右键点击顶级文件夹并选择  `新建 | 目录` 。

2. 将新目录命名为  `test` 。

3. 右键点击新的  `test`  目录并选择  `将目录标记为 | 测试源根目录` 。

`test`  目录在   项目   工具窗口中的颜色会变为绿色 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.nodes.testRoot.svg)。

通过创建专用的测试文件夹，您可以将测试代码与生产代码分离。 这有助于让 IDE 识别测试、应用正确的设置，并一致地组织它们。 这也可确保测试能够正确编译并运行，而不会干扰您的主源文件。

有关更多信息，请参阅 [测试源根目录](testing.html#add-test-root)。

Procedure: 编写应用程序代码

让我们添加一些我们将要测试的代码。

1. 在   项目   工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 中，右键点击  `src`  文件夹并选择  `新建 | Java 类` 。 将该类命名为  `Calculator.java` 。

2. 请将以下代码粘贴到文件中：

```JAVA
import java.util.stream.DoubleStream;

public class Calculator {

    static double add(double... operands) {
        return DoubleStream.of(operands)
                .sum();
    }

    static double multiply(double... operands) {
        return DoubleStream.of(operands)
                .reduce(1, (a, b) -> a * b);
    }
}

```

Procedure: 创建测试

现在让我们创建一个测试。 一个  test 是一段代码，其功能是检查另一段代码是否正常运行。 为进行检查，它会调用被测方法，并将结果与预定义的  预期结果  进行比较。 预期结果可以是例如特定的返回值或异常。

1. 将文本光标置于  `Calculator` 类声明的地方，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))。 或者，右键点击它并选择   显示上下文操作​​  。 从菜单中选择   创建测试  。

![我们将要测试的类的代码](https://resources.jetbrains.com.cn/help/img/idea/2026.3/junit-tutorial-create-test-1.png)

2. 选择我们将要测试的两个类方法。

![创建测试对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/junit-tutorial-create-test-2.png)

3. 编辑器会将您带到新创建的测试类。 请按如下方式修改  `add()` 测试：

```JAVA
@Test
@DisplayName("Add two numbers")
void add() {
    assertEquals(4, Calculator.add(2, 2));
}

```

这个简单的测试将检查我们的方法是否正确地将 2 和 2 相加。  `@DisplayName`  注解为测试指定了一个更方便且信息量更大的名称。

4. 如果您希望在单个测试中添加多个断言并执行它们，而不管其中一些是否失败，该怎么办？ 让我们为  `multiply()`  方法做这件事：

```JAVA
@Test
@DisplayName("Multiply two numbers")
void multiply() {
    assertAll(() -> assertEquals(4, Calculator.multiply(2, 2)),
    () -> assertEquals(-4, Calculator.multiply(2, -2)),
    () -> assertEquals(4, Calculator.multiply(-2, -2)),
    () -> assertEquals(0, Calculator.multiply(1, 0)));
}

```

`assertAll()`  方法接受一系列以 lambda表达式形式表示的断言，并确保它们全部都被检查。 这比采用多个单一断言更方便，因为您将始终看到细化的结果，而不是整个测试的结果。

> **Tip:**
> 在测试和被测试的代码之间导航，请使用 `Ctrl+Shift+T` (Windows), `⌘ ⇧ T` (macOS), `⌘ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ T` (macOS System Shortcuts), `Ctrl+Shift+T` (XWin), `Ctrl+Shift+T` (GNOME), `Ctrl+Shift+T` (KDE), `Ctrl+Shift+T` (Emacs), `Ctrl+Shift+T` (Sublime Text), `Ctrl+Shift+T` (Sublime Text (macOS)), `Ctrl+Shift+T` (Visual Studio), `Ctrl+Shift+T` (Visual Studio (macOS)), `Ctrl+Shift+T` (NetBeans), `Ctrl+Shift+T` (Eclipse), `Ctrl+Shift+T` (Eclipse (macOS))快捷键。

Procedure: 运行测试并查看其结果

在我们设置好测试代码后，我们可以运行测试，找出被测试的方法是否正常工作。

* 要运行单个测试，请在装订线中点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.run.run.svg) 并选择   运行  。

![点击装订区域的 Run 图标后出现的弹窗](https://resources.jetbrains.com.cn/help/img/idea/2026.3/junit_tutorial_run_1.png)

* 要运行测试类中的所有测试，请在测试类声明处点击 ![](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.actions.runAll.svg) 并选择   运行  。

您可以在   运行   工具窗口中查看测试结果。

![测试结果显示在 Run 工具窗口中](https://resources.jetbrains.com.cn/help/img/idea/2026.3/junit-tutorial-results.png)

## See also

### 外部链接

[IntelliJ IDEA blog: Writing Tests with JUnit 5](https://blog.jetbrains.com/idea/2020/09/writing-tests-with-junit-5/) [YouTube: Writing Tests with JUnit 5](https://youtu.be/we3zJE3hlWE)

