How to Compile and Run a C Program on Your Computer

Running a C file means compiling it first, then executing the program it creates

A C file is just text — your computer cannot run it directly. You need a compiler, a tool that translates your C code into machine instructions your operating system understands. The process has two steps: compile the C file into an executable program, then run that program. Which tools you use depends on your operating system.

On Windows, macOS, and Linux, the steps are similar but the software differs slightly. This guide covers the most common free approach on each system, using tools that are either built-in or simple to install.

Key Takeaways

You need a C compiler to turn your C file into a runnable program; GCC and Clang are the most common free compilers.
On Windows, install MinGW or use Windows Subsystem for Linux; on macOS, install Xcode Command Line Tools; on Linux, GCC is usually already there.
Compile your file by opening a terminal or command prompt, navigating to the folder containing your C file, and running the compiler command.
After compilation succeeds, run the resulting executable file from the same terminal window.
Common errors like "command not found" mean the compiler is not installed or not in your system path.

Installing a C compiler on Windows

Windows does not come with a C compiler built-in. The easiest free option is MinGW (Minimalist GNU for Windows), which gives you GCC, the most widely used C compiler. Download the installer from mingw-w64.org, run it, and choose the default settings during installation.

After installation, you need to add MinGW to your system path so Windows knows where to find the compiler. Open the Start menu, search for "Environment Variables", and click "Edit the system environment variables". Click "Environment Variables" at the bottom, then under "System variables" find "Path" and click "Edit". Click "New" and add the folder where MinGW installed (usually C:\Program Files\mingw-w64\x86_64-8.1.0-win32-seh-rt_v6-rev0\mingw64\bin, though the exact path varies). Click OK three times to save.

Alternatively, if you have Windows 10 or later, you can use Windows Subsystem for Linux (WSL), which lets you run Linux inside Windows. This is more complex to set up but gives you a full Linux environment. Most beginners find MinGW simpler.

Installing a C compiler on macOS

macOS includes a compiler, but you need to install the Xcode Command Line Tools to access it. Open Terminal (search for it in Spotlight) and type:

xcode-select --install

A dialog will appear asking to install the tools. Click "Install" and wait — this can take 10 to 30 minutes depending on your internet speed. Once finished, you have GCC and Clang, both free C compilers.

If you already have Xcode installed, the command-line tools are included, and you can skip this step.

Installing a C compiler on Linux

Most Linux distributions come with GCC already installed. Open a terminal and type:

gcc --version

If you see a version number, you are ready to compile. If you see "command not found", install GCC using your distribution's package manager. On Ubuntu or Debian, type:

sudo apt-get install build-essential

On Fedora or Red Hat, type:

sudo dnf install gcc

Enter your password when prompted and wait for installation to finish.

Compiling your C file

Once your compiler is installed, open a terminal (Command Prompt on Windows, Terminal on macOS or Linux) and navigate to the folder containing your C file. If your file is on your Desktop and named hello.c, type:

cd Desktop

Then compile the file by typing:

gcc hello.c -o hello

This tells GCC to compile hello.c and create an executable file named hello (the -o flag means "output"). On Windows, the executable will be hello.exe. If compilation succeeds, you see no error message and the prompt returns.

If you see an error like "hello.c: No such file or directory", you are in the wrong folder. Use ls (macOS and Linux) or dir (Windows) to list files in your current folder and confirm your C file is there. If you see an error about syntax in your C code, fix the code in your text editor and try compiling again.

Running your compiled program

After successful compilation, run the program by typing:

./hello

On Windows, type:

hello.exe

or simply:

hello

The program runs and prints its output to the terminal. If your C program reads input, the terminal waits for you to type. When the program finishes, the prompt returns.

If you see "command not found" or "is not recognized", the executable was not created. Go back and check that compilation succeeded — you should have seen no error messages. If compilation did fail, read the error carefully; it usually points to the line number in your C file that has a problem.

Troubleshooting common problems

Compiler not found: If you type gcc and see "command not found" or "is not recognized as an internal or external command", the compiler is not installed or not in your system path. On Windows, double-check that you added MinGW to your Path and restarted your terminal. On macOS, run xcode-select --install again. On Linux, reinstall GCC using your package manager.

File not found during compilation: Make sure you are in the same folder as your C file. Use ls or dir to list the files in your current folder. The filename is case-sensitive on macOS and Linux, so Hello.c and hello.c are different files.

Compilation errors in your code: The compiler will print the line number and a description of the problem. Common issues include missing semicolons, mismatched braces, or undefined variables. Fix the error in your text editor, save the file, and compile again.

Program runs but produces no output: Your program may be working correctly but not printing anything. Check your C code to confirm it includes printf() statements or other output commands. If the program reads input, it may be waiting for you to type something.

Frequently Asked Questions

Do I need an IDE like Visual Studio or Code::Blocks to run C files?

No. An IDE is optional and makes writing and compiling easier, but you can compile and run C files with just a text editor and a terminal. IDEs are useful if you are writing large programs or working on a team, but for learning C, a text editor and the command line are enough.

What is the difference between GCC and Clang?

Both are free C compilers that work almost identically for basic programs. GCC is older and more widely used; Clang is newer and sometimes gives clearer error messages. For learning C, either one works fine. macOS includes Clang by default, and Windows and Linux typically use GCC.

Can I compile a C file without a .c extension?

Yes, the compiler does not care about the filename extension. However, using .c is a strong convention that tells other people (and your future self) that the file contains C code. Stick with .c unless you have a specific reason not to.

Why does my program crash or behave strangely when I run it?

Compilation succeeds if your code follows C syntax rules, but that does not mean your program logic is correct. If your program crashes or produces wrong output, the bug is in your C code, not the compiler. Use print statements or a debugger to trace what your program is doing and find the mistake.

Can I edit my C file after compiling it?

Yes. The executable file is separate from your C file. You can edit the C file in your text editor, save it, and compile again to create a new executable. The old executable still exists until you delete it, but running it will run the old version of your program.

This guide is for general information only and is not medical, financial, legal, or other professional advice. For decisions specific to your situation, consult a qualified professional. See our Editorial Policy.