如何通过g++与CMake在Windows CMD编译含仅头文件库的C++文件？

Hey there! I’ve been in your shoes—CLion and CMake handle all the include path magic automatically, but when you jump straight to Windows CMD, g++ has no clue where to look for those header-only libraries. Let’s break down the fix step by step:

1. Locate Your Library’s Header Root Path #

First, pin down the top-level directory of your header-only library. This is exactly the path you specified in CMake with include_directories() or target_include_directories(). For example, if your library lives in D:\dev\my_header_lib, that’s your root path.

2. Compile with the -I Flag (Direct Approach) #

The g++ compiler uses the -I flag to add custom include directories. Just append this flag with your library’s root path when compiling your source file.

If your source file is main.cpp and your library is at D:\dev\my_header_lib, your command would look like:

g++ main.cpp -o my_program.exe -I "D:\dev\my_header_lib"

• If you have multiple header-only libraries, add multiple -I flags:

  g++ main.cpp -o my_program.exe -I "D:\dev\lib1" -I "D:\dev\lib2"
  

3. Handle Nested Header Includes #

Don’t stress if your library uses relative paths in its #include statements (like #include "subdir/header.h"). As long as you’ve specified the library’s root directory with -I, g++ will resolve these relative paths correctly automatically.

4. Optional: Set Environment Variables for Repeated Use #

If you don’t want to type the -I path every time, you can add your library’s root to the CPLUS_INCLUDE_PATH environment variable (this tells g++ where to look for C++ headers by default):

Temporary (Current CMD Session Only) #

Run this command in your CMD window:

set CPLUS_INCLUDE_PATH=%CPLUS_INCLUDE_PATH%;D:\dev\my_header_lib

Now you can compile with a simpler command:

g++ main.cpp -o my_program.exe

Permanent (Across All CMD Sessions) #

1. Right-click "This PC" → Properties → Advanced system settings → Environment Variables
2. In the "System variables" section, click New
3. Set the variable name to CPLUS_INCLUDE_PATH and the variable value to your library’s root path (add multiple paths separated by semicolons if needed)
4. Click OK to save changes. Restart any open CMD windows for this to take effect.

5. Verify the Fix #

To confirm g++ is finding your headers, run a preprocessing command to check:

g++ -E main.cpp | findstr "my_header_lib"

If you see references to your library’s headers in the output, you’re all set. If not, double-check your path spelling and make sure you’re using the correct root directory.

内容的提问来源于stack exchange，提问作者IsoFunCode