Mastering cl.exe: Step-by-Step Guide to Compile and Link C++ on Windows

Introduction

When developing C++ applications on Windows, Microsoft Visual C++ (MSVC) offers the powerful command‑line compiler cl.exe. This guide explains how to configure the environment and manually compile and link C++ programs using cl.exe, helping developers understand its core usage and frequent options.

1. Preparing the Environment

Before invoking cl.exe, ensure Visual Studio is installed with the "Desktop development with C++" workload. Then open the appropriate developer command prompt (e.g., "x64 Native Tools Command Prompt for VS 2022") to get the necessary PATH and environment variables.

2. Basic Usage

2.1 Compile a Single Source File

To compile hello.cpp into an executable: cl.exe /EHsc .\hello.cpp The command produces hello.exe; the /EHsc switch enables standard C++ exception handling.

2.2 Compile to an Object File

Use the /c option to stop after compilation and generate an object file: cl.exe /EHsc /c .\hello.cpp This creates hello.obj without linking.

2.3 Link an Object File

You can link the object file directly with cl.exe (or use link.exe): cl.exe .\hello.obj The result is the executable hello.exe.

3. Common Compiler Options

/Fe<name>

: Set the output executable name (e.g., cl /Feoutput.exe hello.cpp). /Fo<name>: Set the object file name (e.g., cl /Fohello.obj /c hello.cpp). /I<path>: Add an include directory. /D<macro>: Define a preprocessor macro (e.g., cl /DDEBUG hello.cpp). /O2: Optimize for speed. /Zi: Generate debugging information.

4. Practical Examples

4.1 Building Multiple Source Files

Compile and link several files in one step: cl /EHsc main.cpp utils.cpp This produces main.exe.

4.2 Using Precompiled Headers

Precompiled headers (PCH) can dramatically reduce compile time. The typical workflow is:

Create pch.h with frequently used includes.

Create pch.cpp that includes only pch.h.

Generate the PCH file: cl /EHsc /Yc"pch.h" pch.cpp Include pch.h in other source files (e.g., main.cpp).

Compile using the PCH:

cl /EHsc /Yu"pch.h" main.cpp

5. Conclusion

By following this guide, readers should be able to manually compile and link C++ programs with cl.exe, understand the most useful compiler switches, and apply techniques such as precompiled headers to improve build efficiency.