14.1 阶段 0 工具链与构建环境
所属:全栈开发面试题库 / 学习路径 / 14 C++ 与系统开发
本页目录
一、阶段定位
本阶段不写业务代码,只解决三件事:把编译器、调试器、构建系统在命令行里跑通;理解一个 .cpp 文件怎么变成可执行文件;学会用包管理器引入第三方库。后面每个阶段都会反复用到这些工具——阶段 2 排查段错误要靠 GDB,阶段 3 编译模板错误要看得懂编译器报错,阶段 6 做性能剖析要靠 perf 与 ASan——这些能力只在 IDE 里点点鼠标是练不出来的。
不掌握本阶段会在后面具体卡在哪:
- 拿到一段
undefined reference to xxx报错,不知道是链接阶段缺库还是头文件路径错,反复在 IDE 里改设置却跑不通命令行构建。 - 程序崩溃时只会按 F5 让 IDE 断在
main,不会用gdb的bt看栈、不会用info registers,段错误原因只能猜。 - 想引入一个 JSON 库,手动下载源码放进
third_party/,版本升级与依赖传递全靠手,到阶段 7 写 RPC 时被 Protobuf 链接错误反复打回。 - 编译器报
error: 'xxx' was not declared in this scope时不知道去看预处理后的.ii,只能在头文件里乱加#include。
本阶段判断自己卡住的标志不是"感觉没学懂",而是:(1) 让你说出预处理、编译、汇编、链接四步各自产出什么文件,你只能说"编译器把 cpp 变成 exe";(2) 命令行里 g++ 报 No such file or directory,你不知道是没装、还是 PATH 没配;(3) 给你一个 .cpp 用了两个源文件,你不会写最小 CMakeLists 把它们编到一起。出现任一现象,先把本阶段六个模块过一遍再进 阶段 1 语言基础与现代特性。
二、阶段目标与投入
学完本页,应当能用可观察的行为证明以下能力:
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
能在命令行用 g++ 或 clang++ 编译、链接并运行一个 .cpp |
不依赖 IDE,在任意目录完成编译运行 |
| 能说出预处理、编译、汇编、链接四步的输入输出 | 用 -E、-S、-c 分别产出对应文件并观察 |
能用 CMake 写一个最小 CMakeLists.txt 组织多源文件工程 |
cmake -B build && cmake --build build 退出码为 0 |
| 能用 GDB 在崩溃时打出栈回溯、查看变量值 | 故意写一个空指针解引用,用 bt 定位到出错行 |
| 能用 vcpkg 或 Conan 引入一个第三方库(如 nlohmann/json) | CMake find_package 找到库并链接成功 |
| 能看懂常见编译错误(语法错、未定义引用、重定义)并定位 | 故意触发三类报错,5 分钟内给出修法 |
建议学时:
- 全职(每天有效学习 4–6 小时):1 周,约 30–35 小时。其中编译链接模型 8 小时、编译器与标志 6 小时、CMake 8 小时、GDB 6 小时、包管理器 4 小时、动手实验 4 小时。
- 在职(每天 2 小时、周末补 4 小时):2 周,约 30 小时。写过 C 的人可把"编译四步"压缩到半天,重点放在 CMake 与 GDB。
学时分配:编译链接模型 25%、编译器标志与警告 15%、CMake 25%、GDB 15%、包管理器 10%、动手实验 10%。
三、先修自检
进入本阶段前不需要写过 C++,但以下基本操作要会;做不到先用一两天熟悉,否则后面命令行实验会频繁卡壳。
| 先修项 | 合格标准 | 不合格时怎么办 |
|---|---|---|
| 文件与目录操作 | 能在终端里新建、进入、删除目录,看懂绝对路径与相对路径 | 用半天熟悉常用终端命令(cd / ls / mkdir / rm) |
| 安装软件 | 能在本机安装一个程序并找到它的安装目录 | 跟着模块 5.1 的步骤装编译器与 CMake |
| 英文界面基础 | 能看懂 command not found、No such file or directory、Permission denied 这类报错大意 |
遇到报错先把英文原文记下来再查 |
| Git 基本操作 | 能 git init、add、commit |
半天熟悉,后续阶段会反复用 |
四、知识地图
"掌握程度"分三档:了解(能查到)、会用(能调通)、能讲清原理(能回答追问)。
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 编译链接 | 预处理、编译、汇编、链接四步;.ii .s .o .a .so 产物 |
能讲清原理 | 04.9.4 编译链接全过程 |
| 编译器 | GCC 13 / Clang 17 / MSVC 19.3x;-Wall -Wextra -Wpedantic -Werror;-std=c++20;-O0/-O2/-g |
会用 | 04.9.4 编译链接全过程 |
| 构建系统 | CMake 3.2x target-based;add_executable、target_link_libraries、find_package |
会用 | 04.9.4 编译链接全过程 |
| 调试器 | GDB 13;run、bt、frame、print、break、info locals |
会用 | 04.9.5 性能优化与工具链 |
| 包管理 | vcpkg / Conan 2.x;find_package 集成 |
了解 | 06.1 通用后端工程 |
| 操作系统 | 进程、可执行文件格式、动态链接器、环境变量 PATH |
了解 | 01.1 操作系统 |
进度管理建议:把这张表打印出来,每完成一个模块把"掌握程度"上调一档;编译链接模型与 GDB 两项必须能对着白板讲清楚再往下走。
五、分模块精讲
5.1 编译器工具链与版本基线
为什么需要它:C++ 没有官方唯一实现,GCC、Clang、MSVC 对同一语法的支持进度有差异,选错编译器或标志会让你在别人机器上跑通的代码在自己机器上报一堆错。
核心机制:
- 本路径基线:GCC 13、Clang 17、MSVC 19.3x(Visual Studio 2022 17.x),都支持 C++20。C++23 特性按"待确认"标注,未在主流编译器稳定落地的不强制要求。
- 常用标志:
-std=c++20指定语言标准;-Wall -Wextra -Wpedantic -Werror把警告当错误;-O0 -g调试用,-O2 -DNDEBUG发布用;-fPIC生成位置无关代码,做动态库必加。 - 三个平台的命令行入口:Linux 一般用
g++;macOS 用clang++(Xcode Command Line Tools);Windows 用 MSVC 开发者命令提示符里的cl,或用 vcpkg 装的g++/clang++交叉编译。
最小可运行示例:
# 验证编译器版本
g++ --version
# g++ (GCC) 13.x
# 编译一个 hello,分四步看产物
g++ -E hello.cpp -o hello.ii # 预处理后
g++ -S hello.ii -o hello.s # 汇编代码
g++ -c hello.s -o hello.o # 目标文件
g++ hello.o -o hello # 链接出可执行文件
./hello
// hello.cpp
#include <iostream>
int main() {
std::cout << "hello, c++20" << std::endl;
return 0;
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
'g++' 不是内部或外部命令 |
Windows 没装 MinGW 或没配 PATH | 装 MSYS2/MinGW,或直接用 MSVC 开发者命令行 |
error: 'xxx' was not declared in this scope |
缺 #include 或命名空间 |
看报错行最上面的 note,补对应头文件 |
| 同一段代码 GCC 能过、MSVC 不过 | 某语法在 MSVC 还没支持 | 看编译器版本与 C++20 特性支持表,降级或换语法 |
5.2 编译链接四步与报错定位
为什么需要它:C++ 的报错 80% 是编译期错,20% 是链接期错。分不清这两类,看到 undefined reference 就只会在头文件里加 #include,越改越乱。
核心机制:
- 预处理(
-E):处理#include、#define、条件编译,产出.ii。 - 编译(
-S):把 C++ 翻译成汇编,产出.s。 - 汇编(
-c):把汇编翻译成机器码目标文件,产出.o(Windows 是.obj)。 - 链接:把多个
.o与库合并成可执行文件,分静态链接(.a/.lib)与动态链接(.so/.dll/.dylib)。 - 编译期错:语法错、类型错、模板错,报错带文件名与行号。
- 链接期错:
undefined reference to xxx、multiple definition of xxx,报错只给符号名,不给行号。
最小可运行示例:
# 两个源文件的工程
# main.cpp: int add(int,int); int main(){ return add(1,2); }
# add.cpp: int add(int a,int b){ return a+b; }
g++ -c main.cpp -o main.o
g++ -c add.cpp -o add.o
g++ main.o add.o -o app # 链接成功
# 故意只编一个,触发链接错误
g++ main.o -o app
# /usr/bin/ld: undefined reference to `add(int, int)'
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
undefined reference to 'xxx' |
缺实现文件或没链接对应库 | 看报错符号,确认是哪个 .cpp 没编、哪个 -l 没加 |
multiple definition of 'xxx' |
在头文件里定义了非 inline 函数或变量 |
头文件只放声明,定义放 .cpp;C++17 起可用 inline 变量 |
| 改了代码行为不变 | 链接的是旧 .o |
cmake --build build --clean-first 或删 build 目录 |
5.3 CMake 最小工程与 target-based 写法
为什么需要它:手写 g++ 命令只能对付几个文件,工程一大就维护不动。CMake 是跨平台事实标准,阶段 6 起引第三方库、阶段 7 做多组件都靠它。
核心机制:
- 最小骨架:
cmake_minimum_required→project→add_executable→target_link_libraries。 - 现代 CMake(3.2x)要求 target-based:不要用
include_directories、link_directories这种目录级命令,全部用target_include_directories、target_link_libraries绑到具体 target。 - 构建分两步:
cmake -B build生成构建脚本(Unix Makefiles / Ninja / Visual Studio),cmake --build build真正编译。 find_package(xxx REQUIRED)找系统或 vcpkg 装的库,再target_link_libraries(app PRIVATE xxx::xxx)。
最小可运行示例:
# CMakeLists.txt
cmake_minimum_required(VERSION 3.20)
project(demo CXX)
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)
add_executable(app
src/main.cpp
src/add.cpp
)
target_compile_options(app PRIVATE -Wall -Wextra -Wpedantic)
# 引入第三方库示例
# find_package(nlohmann_json REQUIRED)
# target_link_libraries(app PRIVATE nlohmann_json::nlohmann_json)
cmake -B build -G Ninja
cmake --build build
./build/app
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
Could not find package config file |
库没装或没给 CMAKE_PREFIX_PATH |
用 vcpkg 工具链文件,或 CMAKE_PREFIX_PATH=xxx cmake .. |
| 改了 CMakeLists 没生效 | CMake 缓存 | 删 build/ 重来,或 cmake -B build 重新配置 |
Windows 下 target_link_libraries 找不到 dll |
运行时 dll 不在 PATH | 把 dll 所在目录加 PATH,或用 vcpkg 的 integrate install |
5.4 GDB 最小调试
为什么需要它:C++ 程序崩溃不会像 Java 那样弹异常栈,它直接段错误。没有 GDB,你只能在代码里加 printf 猜;有了 GDB,bt 一打就知道哪一行崩的。
核心机制:
- 编译时必须加
-g(调试信息),最好用-O0(否则优化后变量可能被优化掉)。 - 常用命令:
run跑起来;break file:line下断点;bt看栈;frame N切到第 N 层;print var看变量;info locals看当前函数局部变量;next单步不进函数;step进函数;watch var监视变量变化。 - 崩溃后用
gdb ./app core(如果有 core dump)或直接gdb ./app再run,复现后bt。
最小可运行示例:
g++ -g -O0 crash.cpp -o crash
gdb ./crash
(gdb) run
# Program received signal SIGSEGV, Segmentation fault.
(gdb) bt
#0 0x0000... in foo () at crash.cpp:5
#1 0x0000... in main () at crash.cpp:10
(gdb) frame 0
(gdb) print p
$1 = (int *) 0x0
// crash.cpp
int foo(int* p) { return *p; } // 第 5 行
int main() {
int* p = nullptr;
return foo(p); // 第 10 行
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
GDB 里看变量显示 <optimized out> |
用了 -O2 没加 -g |
调试时用 -O0 -g |
| 程序崩溃但没生成 core | 系统没开 core dump | ulimit -c unlimited 后再跑 |
| 断点不命中 | 源码与二进制版本不一致 | 重新编译,确认跑的是刚编的那个 |
5.5 包管理:vcpkg 与 Conan 2.x
为什么需要它:C++ 生态没有像 Maven/npm 那样的中央仓库,第三方库要么源码编译要么用包管理器。阶段 7 写 RPC 要 Protobuf、gRPC,写存储引擎要 RocksDB,手动编这些库能耗一周。
核心机制:
- vcpkg:微软出的,命令行
vcpkg install nlohmann-json,装完用-DCMAKE_TOOLCHAIN_FILE=<vcpkg>/scripts/buildsystems/vcpkg.cmake集成。 - Conan 2.x:Python 写的,用
conanfile.txt声明依赖,conan install .生成 CMake 集成文件,跨平台与二进制复用更好。 - 选型:小工具用 vcpkg 足够;跨平台 CI 或有预编译二进制需求用 Conan。
- 不要把第三方源码提交进自己仓库,用包管理器声明版本。
最小可运行示例:
# vcpkg
vcpkg install nlohmann-json
cmake -B build -DCMAKE_TOOLCHAIN_FILE=/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake
cmake --build build
# conanfile.txt (Conan 2.x)
[requires]
nlohmann_json/3.11.3
[generators]
CMakeDeps
CMakeToolchain
5.6 操作系统与命令行排障
为什么需要它:程序起不来、崩了、跑得慢,第一步永远是命令行看进程、看日志、看端口。C++ 服务端开发尤其如此。
核心机制:
- 进程:
ps、top、htop;端口:ss -ltnp(Linux)或netstat -ano(Windows);日志:tail -f、grep。 - 退出码:
0成功,非零失败;echo $?看上一条命令退出码。 - 信号:
Ctrl+C发 SIGINT,kill <pid>发 SIGTERM,kill -9 <pid>发 SIGKILL,阶段 5 会深入信号处理。
最小可运行示例:
# 一条典型排障链路(Linux)
ss -ltnp | grep 8080 # 端口在不在、哪个进程
ps aux | grep app # 进程在不在
tail -200f app.log # 实时看日志
echo $? # 上一条命令退出码
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 命令行编译运行 hello | 不碰 IDE,g++ 四步分别产出文件 | 能看到 .ii .s .o 与可执行文件 |
0.5 小时 |
| 多源文件链接 | 写 add.cpp 与 main.cpp,手动链接 |
故意只编 main 触发 undefined reference,再修 | 1 小时 |
| CMake 最小工程 | 写 CMakeLists,cmake -B build 跑通 |
构建产物在 build/ 下,可执行 |
1 小时 |
| GDB 断崩溃 | 写一个空指针解引用,gdb 打出 bt | 能在栈里定位到出错行与变量值 | 1 小时 |
| vcpkg 引库 | 装 nlohmann/json,CMake find_package | 程序能解析一个 JSON 字符串 | 1.5 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 修链接错误 | 故意删一个 .cpp 触发 undefined reference,再修 |
能说清缺哪个符号、对应哪个文件 | 1 小时 |
| 警告当错误 | 加 -Wall -Wextra -Wpedantic -Werror,修掉所有警告 |
编译 0 警告 | 1 小时 |
| core dump 复现 | ulimit -c unlimited,让程序崩溃生成 core,gdb 读 core |
能从 core 文件打出 bt | 1 小时 |
| 切编译器 | 同一份代码用 GCC 与 Clang 各编一遍 | 两个编译器都 0 警告,差异能解释 | 1 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 手绘编译链接图 | 从 .cpp 到可执行文件,标注每步产物 |
能讲清预处理/编译/汇编/链接职责 | 1 小时 |
| 搭一套可复用 CMake 模板 | 含 C++20 标准、警告、第三方库集成 | 新工程拷过去改个名就能用 | 2 小时 |
| 写一份自己的排障手册 | 整理编译错、链接错、GDB 命令、端口进程命令 | 5 条以上命令可直接照抄 | 1 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
'g++' 不是内部或外部命令 |
编译器没装或 PATH 没配 | where g++ / which g++ |
装 GCC/Clang,配 PATH |
error: 'xxx' was not declared in this scope |
缺 #include 或命名空间 |
看报错最上面的 note | 补对应头文件,加 std:: |
undefined reference to xxx |
缺实现文件或缺库 | nm 看 .o 里有没有该符号 |
补 .cpp 或加 -lxxx |
multiple definition of xxx |
头文件里定义了非 inline 函数 | 看哪个头文件被多个 .cpp 包含 |
头文件只放声明,定义放 .cpp |
GDB 里变量显示 <optimized out> |
用了 -O2 没加 -g |
看编译标志 | 调试用 -O0 -g 重编 |
| 改了代码行为不变 | 链接的是旧 .o |
看产物时间戳 | 删 build/ 重新构建 |
find_package 找不到库 |
库没装或工具链文件没给 | 看 CMake 报错里的路径 | 装库,或给 CMAKE_TOOLCHAIN_FILE |
| Windows 下运行报缺 dll | dll 不在 PATH | dumpbin /dependents app.exe 看依赖 |
把 vcpkg 装的 dll 目录加 PATH |
八、出口条件
全部勾选后进入 阶段 1 语言基础与现代特性。
- [ ] 不依赖 IDE,能在命令行用 g++ 编译链接并运行多源文件工程
- [ ] 能用
-E、-S、-c分别产出.ii.s.o并解释每步职责 - [ ] 能写一个最小 CMakeLists.txt,用 target-based 写法组织多源文件
- [ ] 能用 GDB 让空指针崩溃程序打出 bt,定位到出错行与变量
- [ ] 能用 vcpkg 或 Conan 引入一个第三方库并在 CMake 里 find_package
- [ ] 能区分编译期错与链接期错,并在 5 分钟内给出修法
- [ ] 排障表里随机抽三个现象,能在 5 分钟内给出排查路径
自测题:
- 预处理、编译、汇编、链接四步各自产出什么文件?
- 要点:
.ii(预处理后源码)、.s(汇编)、.o(目标文件)、可执行文件(链接后)。
- 要点:
undefined reference to xxx是哪一步报错?怎么定位?- 要点:链接阶段;用
nm看哪个.o缺该符号,对应哪个.cpp没编或哪个库没链接。
- 要点:链接阶段;用
- 为什么调试时要用
-O0 -g?- 要点:
-g生成调试信息;-O0避免变量被优化掉,GDB 才能看到真实值。
- 要点:
- 现代 CMake 为什么推荐 target-based?
- 要点:依赖关系绑到具体 target,避免全局
include_directories污染,多 target 工程不会互相污染头文件路径。
- 要点:依赖关系绑到具体 target,避免全局
- 静态链接与动态链接的区别?
- 要点:静态库
.a/.lib在链接时打进可执行文件;动态库.so/.dll/.dylib运行时加载,可独立更新。
- 要点:静态库
- vcpkg 与 Conan 2.x 各自适合什么场景?
- 要点:vcpkg 简单,适合单平台小工程;Conan 跨平台、支持二进制复用,适合 CI 与多平台项目。