핵심 요약

C++ Insights는 컴파일러가 소스 코드 이면에서 실제로 수행하는 작업을 다시 C++ 코드로 펼쳐서 보여주는 Clang 기반 소스-투-소스 변환 도구입니다. 람다가 어떤 클래스와 operator()로 바뀌는지, range-for 루프가 begin/end 반복자 루프로 어떻게 전개되는지, 구조체 복사 시 어떤 생성자가 암시적으로 호출되는지를 어셈블리가 아니라 같은 C++ 문법으로 확인할 수 있습니다.

C++의 람다, range-for, auto 추론, 암시적 특수 멤버 함수는 모두 컴파일러가 뒤에서 코드를 만들어 내는 영역입니다. “컴파일러가 실제로 무엇을 하는지” 눈으로 확인하고 싶을 때 C++ Insights가 유용합니다. 이 글에서는 C++ Insights가 무엇인지, 어떻게 설치하고 첫 명령을 실행하는지 등 기본적인 C++ Insights 사용법과 함께 람다·range-for·암시적 생성자가 실제로 어떻게 펼쳐지는지를 검증된 예제로 정리합니다.

C++ Insights란? Compiler Explorer와 무엇이 다른가?

한 줄 답: C++ 코드를 “컴파일러가 이해한 C++ 코드”로 다시 펼쳐 보여 주는 Clang 기반 도구입니다.

같은 코드, 다른 깊이: 원본 C++ 람다가 C++ Insights(Clang AST)를 거치면 class __lambda_5_16과 operator()로 펼친 C++가 되고, 같은 코드를 Compiler Explorer에 넣으면 끝 단계인 어셈블리가 나옴

  1. Compiler Explorer(https://godbolt.org)는 소스 코드를 최종 어셈블리로 보여주지만, C++ Insights는 어셈블리 대신 같은 C++ 문법으로 중간 형태를 보여주기 때문에 읽기 쉽습니다.

  2. 람다가 실제로 어떤 클래스인지, range-for가 어떻게 반복자 루프로 바뀌는지, 복사와 이동 중 어디서 무엇이 호출되는지를 확인할 때 특히 유용합니다.

  3. 구조체 복사 시 암시적 특수 멤버 함수가 어떻게 호출되는지는 별도로 다룰 예정입니다(「복사 생성자 vs 이동 생성자 차이: 언제 무엇이 호출되나?」, 발행 예정).

설치→첫 명령: 웹에서 바로 쓰고, 로컬에선 어떻게 돌리나?

한 줄 답: 웹(cppinsights.io)에서 바로 실행하거나, macOS Homebrew 및 Linux 바이너리를 통해 로컬에 설치할 수 있습니다.

  1. 가장 빠른 방법은 설치 없이 쓰는 것입니다. https://cppinsights.io에 접속해 코드를 붙여넣고, C++ 표준을 선택하면 우측 창에서 펼쳐진 결과를 바로 확인할 수 있습니다.

  2. 로컬에 설치하려면 macOS에서는 brew install cppinsights(Homebrew 포뮬러 페이지: https://formulae.brew.sh/formula/cppinsights, 2026-10-10 기준 stable 21.1)를, Linux에서는 GitHub 릴리스(https://github.com/andreasfertig/cppinsights/releases)의 바이너리 아카이브를 사용합니다. 소스에서 직접 빌드하려면 저장소(https://github.com/andreasfertig/cppinsights)를 참고하면 됩니다. Docker로 실행하는 별도 저장소(https://github.com/andreasfertig/cppinsights-docker)도 있지만, 실제 실행 명령은 이번 글에서 검증하지 못했습니다.

  3. 첫 명령은 insights <YOUR_CPP_FILE> -- -std=c++17 형태입니다. 이번 검증 환경(release v_21.1, insights-ubuntu-amd64.tar.gz, cpp-insights 21.1 / Clang 21.1.8 Ubuntu 빌드)에서 insights lambda.cpp -- -std=c++17을 그대로 실행하면 fatal error: 'stddef.h' file not found로 실패했습니다. README가 안내하는 scripts/getinclude.py도 실행해 보았지만 이 환경에서는 include 경로 외의 컴파일러 인자가 함께 섞여 나왔습니다. 그래서 g++의 include 경로를 -isystem 플래그로 직접 지정한 insights lambda.cpp -- -std=c++17 -isystem/usr/include/c++/14 -isystem/usr/include/x86_64-linux-gnu/c++/14 -isystem/usr/lib/gcc/x86_64-linux-gnu/14/include -isystem/usr/include/x86_64-linux-gnu -isystem/usr/include 명령으로 재실행하자 정상 동작했습니다. 이 로컬 21.1 바이너리의 출력은 cppinsights.io 웹 결과와 약간 달라서, 람다 클래스의 생성자를 public:으로 직접 보여주고 base 멤버 앞에 private:를 표시하며 constexpr 대신 /*constexpr */ 주석으로 표기합니다.

람다·range-for·숨은 생성자는 어떻게 펼쳐지나?

한 줄 답: 람다는 이름 붙은 클래스와 operator()로, range-for는 begin/end 반복자 루프로 변환되어 표시됩니다.

  1. 람다 변환 예시입니다. 아래 코드는 이 글에서 직접 만들어 cppinsights.io(C++17 옵션)로 변환한 것이고, README의 공식 람다 예시는 https://cppinsights.io/s/e4e19791에서 볼 수 있습니다.
#include <cstdio>

int main() {
    int base = 10;
    auto add = [base](int x) { return base + x; };
    std::printf("%d\n", add(5));
}

cppinsights.io 출력(펼친 코드):

#include <cstdio>

int main()
{
  int base = 10;
    
  class __lambda_5_16
  {
    public: 
    inline constexpr int operator()(int x) const
    {
      return base + x;
    }
    
    // private: 
    int base;
  };
  
  __lambda_5_16 add = __lambda_5_16{base};
  printf("%d\n", add.operator()(5));
  return 0;
}

cppinsights.io 실제 출력 대응도: 람다 auto add = [base](int x) { return base + x; }의 캡처 [base]는 멤버 변수 int base로, 본문은 inline constexpr int operator()(int x) const로, 람다 객체는 __lambda_5_16 add = __lambda_5_16{base}로, 호출 add(5)는 add.operator()(5)로 펼쳐짐

  1. range-for 루프가 반복자 기반 루프로 전개되는 예시입니다. 아래 코드는 이 글에서 직접 만들어 cppinsights.io(C++17 옵션)로 변환한 것이고, README의 공식 range-for 예시는 https://cppinsights.io/s/0cddd172에서 볼 수 있습니다.
#include <cstdio>
#include <vector>

int main() {
    std::vector<int> v{1, 2, 3};
    for (int x : v) std::printf("%d ", x);
    std::printf("\n");
}

cppinsights.io 출력(펼친 코드):

#include <cstdio>
#include <vector>

int main()
{
  std::vector<int, std::allocator<int> > v = std::vector<int, std::allocator<int> >{std::initializer_list<int>{1, 2, 3}, std::allocator<int>()};
  {
    std::vector<int, std::allocator<int> > & __range1 = v;
    __gnu_cxx::__normal_iterator<int *, std::vector<int, std::allocator<int> > > __begin1 = __range1.begin();
    __gnu_cxx::__normal_iterator<int *, std::vector<int, std::allocator<int> > > __end1 = __range1.end();
    for(; operator!=(__begin1, __end1); __begin1.operator++()) {
      int x = __begin1.operator*();
      printf("%d ", x);
    }
    
  }
  printf("\n");
  return 0;
}
  1. auto/decltype 추론 결과가 실제 타입으로 펼쳐지는 예시입니다. 아래 코드는 이 글에서 직접 만들어 cppinsights.io(C++17 옵션)로 변환한 것이고, README의 공식 auto 예시는 https://cppinsights.io/s/6c61d601에서 볼 수 있습니다.
#include <vector>

int main() {
    std::vector<int> v{1, 2, 3};
    auto n = v.size();
    auto first = v.front() * 2.0;
    const auto& ref = v;
    return static_cast<int>(n + first + ref.size());
}

cppinsights.io 출력(펼친 코드):

#include <vector>

int main()
{
  std::vector<int, std::allocator<int> > v = std::vector<int, std::allocator<int> >{std::initializer_list<int>{1, 2, 3}, std::allocator<int>()};
  unsigned long n = v.size();
  double first = static_cast<double>(v.front()) * 2.0;
  const std::vector<int, std::allocator<int> > & ref = v;
  return static_cast<int>((static_cast<double>(n) + first) + static_cast<double>(ref.size()));
}
  1. 구조체를 복사 초기화할 때 암시적 복사 생성자가 호출되는 예시입니다. 이 지점은 앞서 언급한 「복사 생성자 vs 이동 생성자 차이: 언제 무엇이 호출되나?」 글과 이어지는 내용입니다.
#include <string>

struct Point {
    int x;
    std::string name;
};

int main() {
    Point a{1, "a"};
    Point b = a;   // 암시적 복사 생성자
    return b.x;
}

cppinsights.io 출력(펼친 코드):

#include <string>

struct Point
{
  int x;
  std::basic_string<char, std::char_traits<char>, std::allocator<char> > name;
  // inline Point(const Point &) noexcept(false) = default;
  // inline ~Point() noexcept = default;
};


int main()
{
  Point a = {1, std::basic_string<char, std::char_traits<char>, std::allocator<char> >("a", std::allocator<char>())};
  Point b = Point(a);
  return b.x;
}
  1. 여기서 보이는 펼친 코드는 Clang의 해석을 기준으로 합니다. __lambda_5_16이나 __gnu_cxx::__normal_iterator 같은 내부 타입 이름은 컴파일러 버전과 표준 라이브러리(여기서는 libstdc++) 구현에 따라 달라질 수 있다는 점이 한계입니다.

이해했는지 Q&A로 확인해 볼까요?

Q1. C++ Insights와 Compiler Explorer 중 언제 무엇을 써야 합니까?

A1. 컴파일러가 코드를 어떻게 해석했는지(C++ 중간 형태)를 볼 때는 C++ Insights를, 최종 기계어나 최적화 결과를 볼 때는 Compiler Explorer를 사용합니다.

Q2. 로컬 실행 시 표준 헤더를 찾지 못하면 어떻게 해야 합니까?

A2. README는 scripts/getinclude.py로 컴파일러의 include 경로를 모으는 방법을 안내합니다. 이 글의 환경처럼 출력에 다른 인자가 섞이면, 표준 헤더 경로를 -isystem 옵션으로 직접 지정하면 됩니다.

Q3. 같은 코드면 C++ Insights 출력은 항상 똑같습니까?

A3. 아닙니다. 이 글의 람다 예제도 cppinsights.io 웹 결과와 로컬 21.1 바이너리 결과가 달랐습니다(생성자 표시, private:, constexpr 표기). 버전·옵션·표준 라이브러리에 따라 달라질 수 있습니다. std::move 자체는 C++ std::move, 복사를 줄이는 이유 글에서 다룹니다.