# Tutorial: Get started with JUnit In this tutorial, you will learn how to set up JUnit for your projects, create tests, and run them to see if your code is operating correctly. It contains just the basic steps to get you started. If you want to know more about JUnit, refer to [the official documentation](https://junit.org/junit5/). To learn more about testing features of IntelliJ IDEA, refer to other topics in this section. You can choose to follow the tutorial using either Maven, Gradle, or the IntelliJ builder. Maven: Procedure: Create a project 1. In the main menu, go to `File | New | Project`. 2. In the New Project wizard, select Java from the New Project list. 3. Specify the name for the project, for example, `junit-tutorial`, and select Maven as a build tool. 4. From the JDK list, select the [JDK](sdk.html#jdk) that you want to use in your project. * If the JDK is installed on your computer, but not defined in the IDE, select ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.nodes.jdk.png) Add JDK from Disk… and specify the path to the JDK home directory. * If you don't have the necessary JDK on your computer, select ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.download.svg) Download JDK . 5. Click Create. > **Tip:** > For more information about working with Maven projects, refer to [Maven](maven-support.html). Procedure: Add dependencies For our project to use JUnit features, we need to add JUnit as a dependency. 1. Open `pom.xml` in the root directory of your project. > **Tip:** > To quickly navigate to a file, press `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)), `Alt+Shift+O` (NetBeans), `Ctrl+Shift+T` (Visual Studio), `⌘ ⇧ T` (Visual Studio (macOS)), `Ctrl+Shift+R` (Eclipse), `⌘ ⇧ R` (Eclipse (macOS)) and enter its name. 2. In `pom.xml`, press `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` (NetBeans), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) and select Dependency. 3. In the dialog that opens, type `org.junit.jupiter:junit-jupiter` in the search field. Locate the necessary dependency in the search results and click Add. 4. When the dependency is added to `pom.xml`, press `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` (NetBeans), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS)) or click ![Reimport All Maven Projects](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.refresh.svg) in the Maven tool window to import the changes. ![The Sync Maven Changes button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/junit-tutorial-maven-reload.png) In the result of adding the dependency, your `pom.xml` file will look similar to this: ```XML 4.0.0 org.example junit-tutorial 1.0-SNAPSHOT 21 21 UTF-8 org.junit.jupiter junit-jupiter-engine 5.7.0 ``` > **Tip:** > The procedure above shows the manual way so that you know what happens behind the scenes and where you set up the testing framework. However, if you just start writing tests, IntelliJ IDEA [will automatically detect > if the dependency is missing > and prompt you to add it](testing.html#add-testing-libraries). Procedure: Write application code Let's add some code that we'll be testing. 1. In the Project tool window `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+1` (NetBeans), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)), right-click the `src/main/java` folder and select `New | Java Class`. Name the class `Calculator.java`. 2. Paste the following code in the file: ```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: Create a project 1. In the main menu, go to `File | New | Project`. 2. In the New Project wizard, select Java from the New Project list. 3. Specify the name for the project, for example, `junit-tutorial`, and select Gradle as a build tool. 4. From the JDK list, select the [JDK](sdk.html#jdk) that you want to use in your project. * If the JDK is installed on your computer, but not defined in the IDE, select ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.nodes.jdk.png) Add JDK from Disk… and specify the path to the JDK home directory. * If you don't have the necessary JDK on your computer, select ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.download.svg) Download JDK . 5. Click Create. > **Tip:** > For more information about working with Gradle projects, refer to [Gradle](gradle.html). Procedure: Add dependencies Newly created Gradle projects usually have the latest JUnit dependency by default. If it is missing, you can add JUnit as a dependency manually. 1. Open `build.gradle` in the root directory of your project. > **Tip:** > To quickly navigate to a file, press `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)), `Alt+Shift+O` (NetBeans), `Ctrl+Shift+T` (Visual Studio), `⌘ ⇧ T` (Visual Studio (macOS)), `Ctrl+Shift+R` (Eclipse), `⌘ ⇧ R` (Eclipse (macOS)) and enter its name. 2. In `build.gradle`, press `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` (NetBeans), `Alt+Insert` (Visual Studio), `⌘ ⌃ N` (Visual Studio (macOS)), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) and select Add Maven artifact dependency. 3. In the tool window that opens, type `org.junit.jupiter:junit-jupiter` in the search field. Locate the necessary dependency in the search results and click Add. 4. When the dependency is added to `build.gradle`, press `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` (NetBeans), `Ctrl+Shift+O` (Visual Studio), `Ctrl+Shift+O` (Visual Studio (macOS)), `Ctrl+Shift+O` (Eclipse), `Ctrl+Shift+O` (Eclipse (macOS)) or click ![Reimport All Gradle Projects](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.refresh.svg) in the Gradle tool window to import the changes. > **Tip:** > The procedure above shows the manual way so that you know what happens behind the scenes and where you set up the testing framework. However, if you just start writing tests, IntelliJ IDEA [will automatically detect > if the dependency is missing > and prompt you to add it](testing.html#add-testing-libraries). Procedure: Write application code Let's add some code that we'll be testing. 1. In the Project tool window `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+1` (NetBeans), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)), right-click the `src/main/java` folder and select `New | Java Class`. Name the class `Calculator.java`. 2. Paste the following code in the file: ```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 build tool: Procedure: Create a project 1. In the main menu, go to `File | New | Project`. 2. In the New Project wizard, select Java from the New Project list. 3. Specify the name for the project, for example, `junit-tutorial`, and select IntelliJ as a build tool. 4. From the JDK list, select the [JDK](sdk.html#jdk) that you want to use in your project. * If the JDK is installed on your computer, but not defined in the IDE, select ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.nodes.jdk.png) Add JDK from Disk… and specify the path to the JDK home directory. * If you don't have the necessary JDK on your computer, select ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.general.download.svg) Download JDK . 5. Click Create. Procedure: Add dependencies For our project to use JUnit features, we need to add JUnit as a dependency. 1. In the main menu, go to `File | Project Structure` (`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` (NetBeans), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))). 2. Under Project Settings, select Libraries and click ![the New Project Library button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.expui.general.add.svg) `| From Maven`. 3. In the dialog that opens, specify the necessary library artifact, for example: `org.junit.jupiter:junit-jupiter:5.9.1` . 4. Apply the changes and close the dialog. ![Manually adding a testing library to a project](https://resources.jetbrains.com.cn/help/img/idea/2026.2/add-testlib-manually.png) > **Tip:** > The procedure above shows the manual way so that you know what happens behind the scenes and where you set up the testing framework. However, if you just start writing tests, IntelliJ IDEA [will automatically detect > if the dependency is missing > and prompt you to add it](testing.html#add-testing-libraries). Procedure: Create a folder for tests 1. In the Project tool window `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+1` (NetBeans), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)), right-click the top-level folder and select `New | Directory`. 2. Name the new directory `test`. 3. Right-click the new `test` directory and select `Mark Directory As | Test Sources Root`. The `test` directory changes the color in the Project tool window to green ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.nodes.testRoot.svg). By creating a dedicated test folder, you separate test code from production code. This helps the IDE recognize tests, apply the right settings, and organize them consistently. It also ensures that tests are compiled and run correctly without interfering with your main source files. Learn more from [Test Sources Root](testing.html#add-test-root). Procedure: Write application code Let's add some code that we'll be testing. 1. In the Project tool window `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+1` (NetBeans), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)), right-click the `src` folder and select `New | Java Class`. Name the class `Calculator.java`. 2. Paste the following code in the file: ```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: Create tests Now let's create a test. A test is a piece of code whose function is to check if another piece of code is operating correctly. To do the check, it calls the tested method and compares the result with the predefined expected result. An expected result can be, for example, a specific return value or an exception. 1. Place the caret at the `Calculator` class declaration and press `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` (NetBeans), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)). Alternatively, right-click it and select Show Context Actions. From the menu, select Create test . ![The code of the class that we are going to test](https://resources.jetbrains.com.cn/help/img/idea/2026.2/junit-tutorial-create-test-1.png) 2. Select the two class methods that we are going to test. ![The Create Test dialog](https://resources.jetbrains.com.cn/help/img/idea/2026.2/junit-tutorial-create-test-2.png) 3. The editor takes you to the newly created test class. Modify the `add()` test as follows: ```JAVA @Test @DisplayName("Add two numbers") void add() { assertEquals(4, Calculator.add(2, 2)); } ``` This simple test will check if our method correctly adds 2 and 2. The `@DisplayName` annotation specifies a more convenient and informative name for the test. 4. Now what if you want to add multiple assertions in a single test and execute all of them regardless of whether some of them fail? Let's do it for the `multiply()` method: ```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))); } ``` The `assertAll()` method takes a series of assertions in form of lambda expressions and ensures all of them are checked. This is more convenient than having multiple single assertions because you will always see a granular result rather than the result of the entire test. > **Tip:** > To navigate between the test and the code being tested, use the `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` (NetBeans), `Ctrl+Shift+T` (Visual Studio), `Ctrl+Shift+T` (Visual Studio (macOS)), `Ctrl+Shift+T` (Eclipse), `Ctrl+Shift+T` (Eclipse (macOS)) shortcut. Procedure: Run tests and view their results After we have set up the code for the testing, we can run the tests and find out if the tested methods are working correctly. * To run an individual test, click ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.run.run.svg) in the gutter and select Run. ![The popup that appears after clicking on the Run icon in the gutter](https://resources.jetbrains.com.cn/help/img/idea/2026.2/junit_tutorial_run_1.png) * To run all tests in a test class, click ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.actions.runAll.svg) against the test class declaration and select Run. You can view test results in the Run tool window. ![The results of the tests shown in the Run tool window](https://resources.jetbrains.com.cn/help/img/idea/2026.2/junit-tutorial-results.png) ## See also ### External Links [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)