핵심 요약
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 기반 도구입니다.

-
Compiler Explorer(https://godbolt.org)는 소스 코드를 최종 어셈블리로 보여주지만, C++ Insights는 어셈블리 대신 같은 C++ 문법으로 중간 형태를 보여주기 때문에 읽기 쉽습니다.
-
람다가 실제로 어떤 클래스인지, range-for가 어떻게 반복자 루프로 바뀌는지, 복사와 이동 중 어디서 무엇이 호출되는지를 확인할 때 특히 유용합니다.
-
구조체 복사 시 암시적 특수 멤버 함수가 어떻게 호출되는지는 별도로 다룰 예정입니다(「복사 생성자 vs 이동 생성자 차이: 언제 무엇이 호출되나?」, 발행 예정).
설치→첫 명령: 웹에서 바로 쓰고, 로컬에선 어떻게 돌리나?
한 줄 답: 웹(cppinsights.io)에서 바로 실행하거나, macOS Homebrew 및 Linux 바이너리를 통해 로컬에 설치할 수 있습니다.
-
가장 빠른 방법은 설치 없이 쓰는 것입니다. https://cppinsights.io에 접속해 코드를 붙여넣고, C++ 표준을 선택하면 우측 창에서 펼쳐진 결과를 바로 확인할 수 있습니다.
-
로컬에 설치하려면 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)도 있지만, 실제 실행 명령은 이번 글에서 검증하지 못했습니다. -
첫 명령은
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 반복자 루프로 변환되어 표시됩니다.
- 람다 변환 예시입니다. 아래 코드는 이 글에서 직접 만들어 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;
}
 { 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)로 펼쳐짐](/_astro/lambda-to-class-ko.CFDHeD-k_ZLABo4.webp)
- 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;
}
- 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()));
}
- 구조체를 복사 초기화할 때 암시적 복사 생성자가 호출되는 예시입니다. 이 지점은 앞서 언급한 「복사 생성자 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;
}
- 여기서 보이는 펼친 코드는 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, 복사를 줄이는 이유 글에서 다룹니다.