Create a unit test project

Unit tests often mirror the structure of the code under test. For example, a unit test project would be created for each code project in the product. The test project can be in the same solution as the production code, or it can be in a separate solution. You can have multiple unit test projects in a solution.

Note

The location of unit tests for native code and the test project structure can be different than the structure that is described in this article. For more information, see Writing unit tests for C/C++.

To create a unit test project

  1. On the File menu, choose New > Project, or press Ctrl+Shift+N.
  1. In the New Project dialog box, expand the Installed node, choose the language that you want to use for your test project, and then choose Test.

  2. Select the project template for the test framework that you want to use, for example MSTest Test Project or NUnit Test Project. Name the project, and then choose OK.

    Test project templates in Visual Studio 2017

  1. On the Create a new project page, type unit test into the search box. Select the project template for the test framework that you want to use, for example MSTest Test Project or NUnit Test Project, and then choose Next.

    Test project templates in Visual Studio 2019

  2. On the Configure your new project page, enter a name for your project, and then choose Create.

  1. In your unit test project, add a reference to the code under test. To add a reference to a code project in the same solution:

    1. Select the test project in Solution Explorer.

    2. On the Project menu, choose Add Reference.

    3. In Reference Manager, select the Solution node under Projects. Select the code project you want to test, and then select OK.

    If the code that you want to test is in another location, see Managing references in a project for information about adding a reference.

Next steps

See one of the following sections:

Writing unit tests

Running unit tests