0.7 — Compiling your first program

Before we can write our first program, we need to learn how to create new programs within our Integrated Development Environment (IDE). In this lesson, we’ll cover how to do that, and you’ll also compile and execute your first program!


To write a C++ program inside an IDE, we typically start by creating a new project (we’ll show you how to do this in a bit). A project is a container that holds all of your source code files, images, data files, etc… that are needed to produce an executable (or library, website, etc…) that you can run or use. The project also saves various IDE, compiler, and linker settings, as well as remembering where you left off, so that when you reopen the project later, the state of the IDE can be restored to wherever you left off. When you choose to compile your program, all of the .cpp files in the project will get compiled and linked.

Each project corresponds to one program. When you’re ready to create a second program, you’ll either need to create a new project, or overwrite the code in an existing project (if you don’t want to keep it). Project files are generally IDE specific, so a project created for one IDE will need to be recreated in a different IDE.

Best practice

Create a new project for each new program you write.

Console projects

When you create a new project, you’ll generally be asked what type of project you want to create. All of the projects that we will create in this tutorial will be console projects. A console project means that we are going to create programs that can be run from the Windows, Linux, or Mac console.

Here’s a screenshot of the Windows console:

Windows console

By default, console applications have no graphical user interface (GUI), they print text to the console, read input from the keyboard, and are compiled into stand-alone executable files. This is perfect for learning C++, because it keeps the complexity to a minimum, and ensures things work on a wide variety of systems.

Don’t worry if you’ve never used a console before, or don’t know how to access it. We’ll compile and launch our programs through our IDEs (which will invoke the console when necessary).

Workspaces / solutions

When you create a new project for your program, many IDEs will automatically add your project to a “workspace” or a “solution” (the term varies by IDE). A workspace or solution is a container that can hold one or more related projects. For example, if you were writing a game and wanted to have a separate executable for single player and multiplayer, you’d need to create two projects. It wouldn’t make sense for both of these projects to be completely independent -- after all, they are part of the same game. Mostly likely, each would be configured as a separate project within a single workspace/solution.

Although you can add multiple projects to a single solution, we generally recommend creating a new workspace or solution for each program, especially while learning. It’s simpler and there’s less chance of something going wrong.

Writing your first program

Traditionally, the first program programmers write in a new language is the infamous hello world program, and we aren’t going to deprive you of that experience! You’ll thank us later. Maybe.


Starting with this lesson, you will see many examples of C++ code presented. Most of these examples will look something like this:

If you select the code from these examples with your mouse and then copy/paste it into your IDE, you may also get the line numbers (depending on how you made the selection). If so, you’ll need to remove the line numbers manually before you compile.

Creating a project in Visual Studio 2019

When you run Visual Studio 2019, you should see a dialog that looks like this:

Visual Studio 2019 Get Started dialog

Select Create a new project.

You’ll then see a dialog that looks like this:

Visual Studio 2019 Create New Project dialog

If you’ve already opened a prior project, you can access this dialog via the File menu > New > Project.

Select Windows Desktop Wizard and click Next. If you don’t see this, then you probably forgot to choose to install the Desktop development with C++ workload when you installed Visual Studio. In that case, go back to lesson 0.6 -- Installing an Integrated Development Environment (IDE) and reinstall your Visual Studio as indicated (note: rather than doing a full reinstall, you can run the Visual Studio installer and modify your existing installation to add the C++ workload).

Next, you’ll see a dialog that looks like this:

Visual Studio 2019 Configure New Project dialog

Replace the existing project name with HelloWorld.

It’s recommended that you also check the Place solution and project in the same directory, as this reduces the number of subdirectories that get created with each project.

Click Create to continue.

Finally, you’ll see one last dialog:

Visual Studio 2019 Project options dialog

Make sure the Application type is set as Console Application (.exe) and that the Precompiled Header option is unselected. Then click OK.

You’ve now created a project! Jump down to the Visual Studio Solution Explorer section below to continue.

Creating a project in Visual Studio 2017 or older

To create a new project in Visual Studio 2017 or older, go to the File menu > New > Project. A dialog box will pop up that looks something like this:

Visual Studio 2017 New Project dialog

First, make sure Visual C++ is listed on the left side. If you don’t see Visual C++, then you probably forgot to choose to install the Desktop development with C++ workload when you installed Visual Studio. In that case, go back to lesson 0.6 -- Installing an Integrated Development Environment (IDE) and reinstall your Visual Studio as indicated (note: rather doing a full reinstall, you can run the Visual Studio installer and modify your existing install to add the C++ workload).

If you’re using Visual Studio 2017 v15.3 or newer, underneath Visual C++, select Windows Desktop and then select Windows Desktop Wizard in the main window.

If you don’t see Windows Desktop as an option, you’re probably using an older version of Visual Studio. That’s fine. Instead, choose Win32 and then Win32 Console Application in the main window.

Down below, in the Name field, enter the name of your program (replace the existing name with HelloWorld). In the Location field, you can optionally select a different location for your project to be placed into. The default is fine for now.

Click OK. If you’re using an older version of Visual Studio, the Win32 Application Wizard will launch. Press Next.

At this point, you should see a wizard dialog that looks something like this (older versions of Visual Studio use a different style, but have most of the same options):

Visual Studio 2017 Desktop wizard

Make sure you uncheck Precompiled Header.

Then click Ok or Finish. Now your project is created!

Visual Studio Solution Explorer

On the left or right side of the window, you should see a window titled Solution Explorer. Inside this window, Visual Studio has created a solution for you (Solution ‘HelloWorld’). Within that, with the name in bold, is your new project (HelloWorld). Within the project, Visual Studio has created a number of files for you, including HelloWorld.cpp (underneath the Source Files tree item). You may also see some other .cpp or .h files, which you can ignore for now.

Visual Studio 2019 initial windows

In the text editor, you will see that Visual Studio has already opened HelloWorld.cpp and created some code for you. Select and delete all of the code, and type/copy the following into your IDE:

To compile your program, either press F7 (if this doesn’t work, try Ctrl-Shift-B) or go to the Build menu > Build Solution. If all goes well, you should see the following appear in the Output window:

1>------ Build started: Project: HelloWorld, Configuration: Debug Win32 ------
1>HelloWorld.vcxproj -> c:\users\alex\documents\visual studio 2017\Projects\HelloWorld\Debug\HelloWorld.exe
========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========

This means your compile was successful!

Q: I got error C1010 ("fatal error C1010: unexpected end of file while looking for precompiled header. Did you forget to add '#include "stdafx.h"' to your source?"). What now?

You forgot to turn off precompiled headers when you created your project. Recreate your project (as per the instructions above) and make sure to disable precompiled headers.

To run your compiled program, press Ctrl-F5, or go to the Debug menu and choose Start Without Debugging. You will see the following:

Program run

That is the result of your program! Congratulations, you’ve compiled and run your first program!

Creating a project in Code::Blocks

To create a new project, go to File menu > New > Project. A dialog box will pop up that looks like this:

Code::Blocks Project Dialog

Select Console application and press the Go (or Create) button.

If you see a console application wizard dialog, press Next, make sure C++ is selected and press Next again.

Now you will be asked to name your project. Title the project HelloWorld. You can save it wherever you wish. On Windows, we recommend you to save it in a subdirectory of the C drive, such as C:\CBProjects.

Code::Blocks Save Project Dialog

You may see another dialog asking you which configurations you want enabled. The defaults should be fine here, so select Finish.

Now your new project has been created.

On the left side of the screen, you should see a Management window, with the Projects tab selected. Inside that window, you’ll see a Workspace folder, with your HelloWorld project inside of it:

Code::Blocks Workspace

Inside the HelloWorld project, expand the Sources folder, and double click on “main.cpp”. You will see that a hello world program has already been written for you!

Replace that one with the following:

To build your project, press Ctrl-F9, or go to Build menu > Build. If all goes well, you should see the following appear in the Build log window:

-------------- Build: Debug in HelloWorld (compiler: GNU GCC Compiler)---------------
mingw32-g++.exe -Wall -fexceptions -g -std=c++14  -c C:\CBProjects\HelloWorld\main.cpp -o obj\Debug\main.o
mingw32-g++.exe  -o bin\Debug\HelloWorld.exe obj\Debug\main.o   
Output file is bin\Debug\HelloWorld.exe with size 1.51 MB
Process terminated with status 0 (0 minute(s), 0 second(s))
0 error(s), 0 warning(s) (0 minute(s), 0 second(s))

This means your compile was successful!

To run your compiled program, press Ctrl-F10, or go to Build menu > Run. You will see something similar to the following:

Program run

That is the result of your program!

For Linux users

Linux users may need to install the additional packages before Code::Blocks will compile. Please see the Code::Blocks installation instructions in lesson 0.6 -- Installing an Integrated Development Environment (IDE) for more info.

If you’re using g++ on the command line

In this case, you don’t need to create a project. Simply paste the following into a text file named HelloWorld.cpp and save your file:

From the command line, type:

g++ -o HelloWorld HelloWorld.cpp

This will compile and link HelloWorld.cpp. To run it, type:

HelloWorld (or possibly ./HelloWorld), and you will see the output of your program.

If you’re using other IDEs or a web-based compiler

You will have to figure out how to do the following on your own:
1) Create a console project (IDEs only)
2) Add a .cpp file to the project (IDEs only, if one isn’t auto-created for you)
3) Paste the following code into the file:

4) Compile the project
5) Run the project

If compiling fails

It’s okay, take a deep breath. We can probably fix it. :)

First, look at the error message that the compiler gave you. Most often, it will contain a line number indicating which line was in error. Examine both that line and the lines around it, and make sure there are no typos or misspellings. Also make sure you’re not including line numbers in your code.

Second, look at the Q&A in lesson 0.8 -- A few common C++ problems, as your issue may be covered there.

Third, read the comments below -- someone may have encountered the same issue.

Finally, if all of the above fail, try searching for your error message on Google. It’s likely someone else has encountered this before and figured out how to fix it.

If your program runs but the window flashes and closes immediately

Some IDEs don’t automatically pause the console screen after the program has finished executing. Your program is running, but the output window is closing before you can view the results.

If this is the case with your IDE, the following two steps will fix your problem:

First, add or ensure the following lines are near the top of your program (Visual Studio users, make sure these lines appear after #include “pch.h” or #include “stdafx.h”, if those exist):

Second, add the following code at the end of the main() function (just before the return statement):

This will cause your program to wait for the user to press a key before continuing, which will give you time to examine your program’s output before your IDE closes the console window.

Other solutions, such as the commonly suggested system("pause") solution may only work on certain operating systems and should be avoided.

Your anti-virus or anti-malware may also be blocking execution of the program. If that’s the case, try temporarily disabling your scanners and see if the problem resolves.

For Visual Studio users

Visual Studio will not pause at the end of a console application if it is run with debugging (Debug Menu > Start Debugging). If you want it to pause, you can either use the code solution above, or run your program without debugging (Debug Menu > Start Without Debugging).


Congratulations, you made it through the hardest part of this tutorial (installing the IDE and compiling your first program)!

Don’t worry if you don’t understand what all the different lines in the Hello World program do. We’ll look at and explain each line in detail at the start of the next chapter.

0.8 -- A few common C++ problems
0.6 -- Installing an Integrated Development Environment (IDE)

783 comments to 0.7 — Compiling your first program

  • Boteomap2

    How to compile a single cpp file in Visual Studio without creat project?

  • Mehdi

    I am using " Borland c++ ", is it a good compiler? And can i use it for your tutorial?

  • Niko

    I have a problem. when i go to new project, i can see visual C++ But inside that theres only windows universal and other, i dont know what to do

    • Alex

      It sounds like you installed the wrong workload. Reinstall your compiler, and make sure you choose "Desktop development with C++" instead of "Universal Windows Platform development" on the workloads screen.

  • shani

    using namespace std;
    int main(){

       cout<<"Welcome to c++";
       return 0;



  • Hello I have succesfully written and compiled the "hello World" project. I am using Visual Studio 2017. I have an issue with the CREATING A PROJECT IN CODE::BLOCKS. When I go to "File menu>new>project" I do NOT reach the "Dialog Box/New From Template" nor the following screens that are mentioned. Am I opening up the wrong command on the upper command menu?? All that occurs is a new project opens up like the first one. Please help?

  • fregol

    My console didn't close instantly and I've used both Bloodshed's DevC++ and Visual Studio 2017. I guess the last part is not needed anymore for these two IDEs?

  • linnar

    okay, I'm not quite sure if this has been asked before. so I have Microsoft visual studio in the new projects under visual C++ I can only find Windows universal and other.
    in windows universal, there are only blank app, directX11 app, DirectX12 app, DirectX 11 and XAML App, Unit Test App, DLL, Static Library, Windows Runtime Component, and Windows Application Packaging Project; each of these has (Universal Windows) after them except the last.

  • Yves

    I was blocked by this simple mistake "To compile your program, either press F7..." whereas it should read "To compile your program, either press Ctrl-F7"...

    • Alex

      In the latest version of Visual Studio, ctrl-F7 compiles a single file, whereas F7 compiles the whole project (which is more often what you want).

      Did F7 not work at all for you? If so, what version of Visual Studio are you using?

      • DVecc

        f7 doesn't do anything running on the latest build of Visual Studios 2017 as of the date of this comment. ctrl-f7 is the shortcut to compile while ctrl-shift-B is the shortcut to build. Reading some old articles from May it seems like they accidentally assigned a different feature to the same shortcut of f7 and subsequently changed the compile shortcut in a future release.

        Did you mean for us to build the entire project or just compile the project?

        • Alex

          I just upgraded to Visual Studio 15.9.2 and I still see F7 is the shortcut key for "Build solution". Per it looks like the removal of F7 as a "build solution" command was inadvertent, and they've fixed the issue.

          Can anybody else whether F7 works/doesn't work on a fresh install of the latest version of Visual Studio?

  • Daniel

    I'm not sure how you got to the 'console application' part in the 'Code::Blocks' section. I'm using IDE.

  • Messi

    Alex! they just need to put this command:


    before return 0; for those who have the 'flash and close immediately' problem.

  • olander

    i can't even figure out where to find the command line, am i blind or something or have i just skipped something?

  • I am m new to programming and I want to learn C++. Before reading this article I was in fear how difficult a  C programming will be! But thanks to site admin it was not as difficult as people think. Thank you so much

  • Dan

    I get this error message after clicking Build in Code Blocks:

    ld.exe      cannot find -lWs2_32.lib

    Does anyone know why I get this error.

  • Juan C. Luna H.

    For linux users, must install c++ essentials before to work with Code::Blocks

    Execute this command on terminal

  • Pochi

    I get the following error, i double checked to make sure i unchecked precompiled. Not sure what's goin on.

    1>------ Build started: Project: HelloWorld2, Configuration: Debug Win32 ------
    1>Object reference not set to an instance of an object.
    ========== Build: 0 succeeded, 1 failed, 0 up-to-date, 0 skipped ==========

  • vbot


    After starting "HelloWorld" the process "xxxx" automatically exits with exit code "0". So there is not just the desired text-output and "press any key ..."-message in the console (like in your example output), but also the mentioned exit-message above the "press any key ..."-message.

    Question: Why? / Is this bad?
    I'm using MS VS Community 2017 15.8.5

    Thanks! + great tutorial so far! :)

    • vbot


      Ok, it's nothing bad, as explained in Lesson 1.1 - Structure of a program:

      "This particular return statement returns the value of 0 to the operating system, which means “everything went okay!”. Non-zero numbers are typically used to indicate that something went wrong, and the program had to abort. We will discuss return statements in more detail when we discuss functions."


    • Alex

      The "return 0" statement returns a 0 value to the operating system (we cover this in the next chapter). Your IDE is taking the liberty of showing you what that return value is in order to potentially help you debug your program. This is IDE-specific behavior.

  • Ryan

    Hello! I wanted to point out a potential typo I noticed in 'Creating a project in Visual Studio'. Where you said 'older version of Visual Studio have a different style', I think you accidentally didn't pluralize 'version'.

  • Adil Numan

    i started with first project helloworld but after doing exactly what asked to do but still when i am trying to build project its giving error
    MSB6006: "cmd.exe" exited with code -1073741515

    • Alex

      This is some kind of misconfigured compiler error. Try reading here and see if any of those solutions are applicable. If that doesn't help, I can only suggest a google search to see if it turns anything up further.

  • Azeara

    There is a ton of code here and I have no idea what's going on. You've talked about Compilers Linkers IDEs Executable programs and explained it. But then you don't teach us code until after we or at least me are ridiculously confused and you even reference code without explaining it in the slightest. I'm sure it gets better as you move on but I'm going to somewhere that actually makes sense and explains the things that we couldn't possibly understand if we have no code background.

    • Hi Azeara!

      This first lessons are just about setting up a coding environment so you can follow along in the upcoming chapters. If you already have an IDE or editor/compiler running you can skip chapter 0. Chapter 1 is where the coding begins.

  • Akshay

    why after installing and copying this code in codeblocks ,it doesn't build? (64 bit compiler)

  • Yunus

    #include "pch.h"
    Instead of
    #include "stdafx.h"
    Fixed the prob for me.

  • Math

    I don't find "win32" as a possibility. the possibilities are :
    Windows Deskstop, General, ATL, CMake and Test. Wich one should i pick?

    I use Visual btw

  • pouya akhgari

    hi, i plan on starting to learn c++ and i have a question to ask:
    since this tutorial was published in 2007 changes have been made to c++, and i was wondering: after learning all of lessons would it be hard for me to get updated or not?

  • Hassaan

    what is the difference between



  • Roemer

    Im using VS but i follow your instructions but then this happens...
    Severity    Code    Description    Project    File    Line    Suppression State
    Error    MSB4024    The imported project file "C:\Users\Roemer Caliboso\AppData\Local\Microsoft\MSBuild\v4.0\Microsoft.Cpp.x64.user.props" could not be loaded. Root element is missing.ConsoleApplication2    C:\Users\James Caliboso\source\repos\ConsoleApplication2\ConsoleApplication2\ConsoleApplication2.vcxproj
    Do you have any solution?

  • Josh

    What if I'm using Visual Studio on Mac? It doesn't show up with the Visual C++ nor the Win32. What should I do?

  • Kaitlynn

    Is there a reason you'd suggest against using namespace(std)?

  • Crystal blue

    It says Compilation successful but then just everything freeze. Only hello world is seen in the screen.
    Can you please help me out?

    • Kaitlynn

      Only hello world should be seen in the screen as this is a simple output program. It's simply attempting to display the words : "Hello World!" in your command prompt. In your code it shows
      cout << "Hello World!" << endl;
      return 0;

      That return 0 tells the compiler that there is nothing else in that function for it to compile and since you don't have any other functions (This is main, if you don't already know) it stops there.

  • Brook

    here I am again. I also tried "not using precompiled headers" in the solution explorer properties. IDK. I'll just keep going with what I have till I run across something or someone give me a lead. I'm not going to spend too much time worrying about it.

  • Brook

    using vs 2017 community

    I get an error when using stdafx.h.
    cannot open source file "stdafx.h"
    cannot open precompiled header file: Debug\HelloWorld/pch: No such file or directory.

    I right clicked solution explorer->properties->precompiled headers->precompiled header Use:(/Yu).

    Not letting me do it. Am I missing something?
    in the meantime, I'm using #include "Windows.h"... is this bad?

Leave a Comment

Put all code inside code tags: [code]your code here[/code]