在 Linux 下排查 C++ 配置/编译/运行错误,通常可以按“从配置 → 编译 → 链接 → 运行”的顺序系统性排查。下面给你一套实战型排查清单。
先区分错误阶段:
| 阶段 | 常见表现 |
|---|---|
| 配置阶段 | cmake / configure 报错 |
| 编译阶段 | g++ 报错(语法、头文件) |
| 链接阶段 | undefined reference |
| 运行阶段 | 启动失败、库找不到 |
cmake -B build -S .
✅ 找不到编译器
CMAKE_CXX_COMPILER not found
排查:
which g++ clang++
g++ --version
✅ 找不到依赖库
Could NOT find OpenCV (missing: OpenCV_DIR)
解决:
sudo apt install libopencv-dev
# 或
export OpenCV_DIR=/path/to/opencv/lib/cmake/opencv4
✅ 开启详细输出
cmake --trace-expand .
检查:
make V=1 # 显示完整命令
重点看:
CXX, CXXFLAGSLDFLAGS, LIBSfatal error: xxx.h: No such file or directory
解决:
# 查找头文件
find / -name xxx.h 2>/dev/null
# 添加 include 路径
-I/path/to/include
CMake:
include_directories(/path/to/include)
error: ‘nullptr’ was not declared
解决:
g++ -std=c++11 main.cpp
CMake:
set(CMAKE_CXX_STANDARD 17)
undefined reference to `pthread_create'
解决:
g++ main.cpp -lpthread
CMake:
target_link_libraries(app pthread)
❌ 错误:
g++ -lfoo main.cpp
✅ 正确:
g++ main.cpp -lfoo
运行时:
error while loading shared libraries: libxxx.so
排查:
ldd ./your_program
解决:
export LD_LIBRARY_PATH=/path/to/lib:$LD_LIBRARY_PATH
或:
sudo ldconfig
ulimit -c unlimited
./app
gdb ./app core
常用 gdb:
bt
frame 0
print var
env | grep -i yourlib
1. 看完整错误信息(不要只看下一个错)
2. 判断阶段(配置 / 编译 / 链接 / 运行)
3. 打开详细模式(make V=1 / cmake --trace)
4. 用 find / ldd / gdb 定位
5. 精简最小复现样例
你可以直接贴出:
我可以帮你 逐行分析并给出修改方案。