How To Run C++ Program In Visual Studio | Build And Run

Running a C++ program in Visual Studio feels smooth once you know which buttons to press and which project type to pick. This guide walks you through the full path: preparing Visual Studio, creating a C++ console project, building and running your code, wiring in existing files, and fixing problems when the program refuses to start.

The steps here match the current Visual Studio 2022 experience. Microsoft’s own Install C++ support in Visual Studio guide uses the same menus and workloads you will see on a fresh install.

Prepare Visual Studio For C++ Programs

Before you run a C++ program in Visual Studio, the IDE needs the C++ compiler, standard library, and debugger. Visual Studio ships with these tools, but they are added through workloads during installation.

On Windows, the workload you care about is Desktop development with C++. It gives you the MSVC compiler, libraries, and project templates used by console apps and classic desktop projects.

• Install Visual Studio 2022 Or Later — Download the installer from the Visual Studio site, launch it, and sign in if needed. The Community edition is free for individual use and learning.
• Select Desktop Development With C++ — When the installer shows workloads, tick Desktop development with C++. This adds the compiler, debugger, and project templates required for C++ console programs.
• Let The Installer Finish — Keep Visual Studio closed while the installer runs. When it finishes, launch Visual Studio from the Start menu.
• Confirm C++ Templates Are Available — In Visual Studio, pick File > New > Project and search for “Console App”. Make sure a C++ Console App template appears in the list.

If the C++ templates are missing, reopen the Visual Studio Installer and modify your installation to include the C++ desktop workload. The same recommendation appears in Microsoft’s C++ desktop IDE overview.

One more note: Visual Studio is different from Visual Studio Code. This article is about the full Visual Studio IDE on Windows, not the VS Code editor with extensions. The menus, shortcuts, and project system are not the same.

How To Run C++ Program In Visual Studio Step By Step

This is the core workflow for running C++ code as a console application in Visual Studio. You create a project, add or edit a source file, build the program, then run it with or without the debugger.

1. Create A New C++ Console Project — In Visual Studio, choose File > New > Project. In the search box, type “Console App”. Pick the template tagged with C++, Windows, and Console. Give the project a name such as HelloCppVS, choose a folder, and select Create.
2. Check The Language And Project Type — Confirm the project uses C++ rather than C# or .NET. In Solution Explorer, your main file should end with .cpp, and the project type should be a C++ console application.
3. Open The Main C++ File — Visual Studio usually opens a starter file for you, such as HelloCppVS.cpp. If not, double-click the main .cpp file under the project node in Solution Explorer.
4. Replace The Template Code — Keep things simple for a first run. Replace the contents of the file with a short program like this:

#include 

int main()
{
    std::cout << "Hello from Visual Studio!" << std::endl;
    return 0;
}

5. Save The File — Press Ctrl+S or use File > Save All. This makes sure the editor and the build system see the same code.
6. Build The Solution — On the menu bar, select Build > Build Solution or press Ctrl+Shift+B. Watch the Output and Error List panes. A successful build message means the compiler produced an executable.
7. Run Without Debugging (Ctrl+F5) — To run your C++ program as a simple console app, use Debug > Start Without Debugging or press Ctrl+F5. A terminal window opens, prints “Hello from Visual Studio!”, and waits for you to press a key before closing.
8. Run With Debugging (F5) — To watch variables, step through code, and pause on breakpoints, use Debug > Start Debugging or press F5. The debugger attaches to the process and lets you control execution.

The run commands above mirror the steps in Microsoft’s own build and run C++ console app tutorial, so you can switch between this article and the official docs without getting lost.

What Happens When You Build And Run

When you build the solution, Visual Studio calls the MSVC compiler and linker behind the scenes. A .exe file appears in the project’s Debug or Release folder, depending on the configuration setting near the top of the window. When you run the program, Visual Studio starts that executable and either attaches the debugger or lets it run freely, based on the command you chose.

Run A C++ Program In Visual Studio From Existing Code

If you already have a C++ file or a small group of files, you can still run the program in Visual Studio without rewriting it. The simplest route for beginners is to wrap that code in a console project.

• Create A Console Project Shell — Use the same steps as before to create a C++ Console App project. Pick a short project name and make sure it builds once with the default code so you know the setup is sound.
• Add Existing C++ Files To The Project — In Solution Explorer, right-click the project name (not the solution) and choose Add > Existing Item…. Browse to your .cpp and header files, select them, and choose Add.
• Remove Or Adjust The Template Main Function — If your own code already has a main function, delete the template one so there is only a single entry point. If your code does not have main yet, move the template one into your primary source file and adjust it to call your functions.
• Set The Project As Startup — In multi-project solutions, right-click the console project and pick Set as Startup Project. This tells Visual Studio which program to run when you press F5 or Ctrl+F5.
• Build And Run As Usual — Build the solution, check for errors, then run with Ctrl+F5 or F5. If the program compiles cleanly, Visual Studio launches it just like the “Hello” example.

For more advanced layouts, such as CMake-based projects or large code bases, Visual Studio can open these directly and map them into its project and solution view. That route uses the same run shortcuts, but it expects you to know how the original build system is wired.

Choose Debug Or Release When You Run C++

Before you press F5, glance at the configuration dropdown near the top of the window. Typical values are Debug and Release, and they change how Visual Studio builds and runs your C++ program.

Use Debug While You Build Features

Debug builds turn on rich runtime checks and keep extra information in the binary so the debugger can show you lines, variables, and call stacks. That makes stepping through C++ code much simpler.

• Pick The Debug Configuration — In the toolbar, set the configuration box to Debug. Also choose the platform you want, such as x64 or Win32.
• Set Breakpoints — Click the left margin next to a line of code to drop a breakpoint. A red dot appears. When you run with F5, execution pauses on this line.
• Step Through Code — Use F10 to step over the next line, F11 to step into a call, and Shift+F11 to step out.
• Inspect Variables — Hover over variables, use the Autos and Locals windows, and watch expressions in the Watch window while the program is paused.

Switch To Release For Final Builds

Release builds turn off many checks and enable compiler optimizations so the executable is smaller and faster. Use this configuration when you want to measure run time or ship a build to someone else.

• Pick The Release Configuration — Change the configuration dropdown from Debug to Release. Keep the target platform the same unless you need a different one.
• Rebuild The Solution — Use Build > Rebuild Solution so Visual Studio compiles every file with the Release settings.
• Run Without Debugging — Use Ctrl+F5 so the program runs with minimal overhead from the debugger.

It is common to write and test new C++ code in Debug, then switch to Release once your program is stable and you want to measure performance or share the binary.

Fix Problems When A C++ Program Will Not Run In Visual Studio

Sometimes you press F5 and nothing useful happens. Maybe the build fails, the console window closes instantly, or Visual Studio complains about startup items. Here are frequent causes and simple fixes.

• No Desktop C++ Workload Installed — If you do not see any C++ project templates, open the Visual Studio Installer from the Start menu, choose your installed edition, and pick Modify. Tick Desktop development with C++, then complete the change and restart Visual Studio.
• Build Failed Before Run — Check the Error List pane. If there are compiler errors, the executable may not exist or may be out of date. Fix the errors first, then build again before trying to run.
• Wrong Startup Project — In solutions that hold several projects, Visual Studio runs the one marked as startup. Right-click your console project and choose Set as Startup Project, then press Ctrl+F5 again.
• Missing Or Invalid Main Function — A C++ console program needs a valid main entry point, such as int main() or int main(int argc, char* argv[]). If the linker complains about an entry point, search your code for extra main definitions or fix the signature.
• Console Window Closes Instantly — If the window appears and disappears, you are probably using the normal F5 command and the program ends quickly. Use Ctrl+F5 so Visual Studio adds a pause at the end of the run. Another option is to add a line such as std::cin.get(); near the end of main.
• Architecture Mismatch — When linking against libraries, make sure the target platform matches their build. If you linked x86 libraries, pick Win32 as the platform; if you linked x64 libraries, pick x64.
• Path Issues With External Tools — If your C++ program calls other tools or reads files, check that the working directory is what you expect. You can adjust this under Project > Properties > Debugging by changing the Working Directory field.

Spend a few minutes reading any error message Visual Studio shows at the bottom of the window. C++ errors can look dense, but the first line usually points to the real issue: a missing semicolon, a type mismatch, or a missing file.

Handy Visual Studio Shortcuts For Running C++ Code

Once you know the basics, keyboard shortcuts save time. This quick reference keeps the main run-related commands in one place so you do not have to scan menus every time.

Action	Menu Path	Shortcut
Build solution	Build > Build Solution	Ctrl+Shift+B
Rebuild solution	Build > Rebuild Solution	None by default
Start without debugging	Debug > Start Without Debugging	Ctrl+F5
Start with debugging	Debug > Start Debugging	F5
Stop debugging	Debug > Stop Debugging	Shift+F5
Step over	Debug > Step Over	F10
Step into	Debug > Step Into	F11

You do not need to memorize every shortcut at once. Start with Ctrl+Shift+B for build, Ctrl+F5 for a normal run, and F5 when you want to debug. The rest will become second nature over time.

Run C++ In Visual Studio With Confidence

Running a C++ program in Visual Studio comes down to a repeatable pattern: create or open a console project, keep a clean main function, build the solution, then run it with the command that matches your goal. Use Debug builds when you want insight, Release builds when you care about speed, and switch between F5 and Ctrl+F5 depending on whether you need the debugger.

Once this routine feels natural, Visual Studio turns into a comfortable home for C++ work. You spend less time wrestling with tools and more time shaping the program itself, whether it is a small lab exercise, a command-line utility, or the core logic for a larger app.