Debian如何调试cximage

在 Debian 上调试 CxImage（一个 C++ 图像处理库），通常分为 环境准备、编译调试版本、使用调试器、定位问题 四个步骤。下面按常见场景给你一套实用流程。

一、准备调试环境

1. 安装基础工具

sudo apt update
sudo apt install build-essential gdb cmake git

如果你用的是 CxImage 源码（而不是系统库），还需要：

sudo apt install libpng-dev libjpeg-dev libtiff-dev libgif-dev

二、获取并编译 CxImage（调试版本）

1. 获取源码

git clone https://github.com/hujiandong/cximage.git
cd cximage

如果使用的是老版本 CxImage（VC 风格项目），可能需要手动写 CMakeLists.txt 或 Makefile。

2. 编译为调试版本（关键）

使用 CMake（推荐）

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
make -j$(nproc)

或直接 g++

g++ -g -O0 -o test_cx \
    main.cpp \
    *.cpp \
    -I. \
    -lpng -ljpeg -ltiff -lgif

✅ 关键点

-g：生成调试符号
-O0：关闭优化，方便单步调试

三、使用 GDB 调试 CxImage

1. 启动调试

gdb ./test_cx

2. 常用 GDB 命令

run
bt              # 查看调用栈
list            # 查看源码
break main
break CxImage.cpp:123
step
next
print variable

3. 示例：调试加载图片失败

CxImage img;
bool ret = img.Load("test.jpg", CXIMAGE_FORMAT_JPG);

GDB 中：

break CxImage::Load
run
step
print ret

四、常见问题调试方法

1. 程序崩溃（Segmentation fault）

gdb ./test_cx
run
bt

重点看：

是否访问空指针
是否未初始化 CxImage

2. 图片加载失败

调试建议：

确认路径正确
确认格式支持
打印内部错误码（如果有）

示例：

if (!img.IsValid()) {
    printf("Image load failed\n");
}

3. 内存问题（强烈推荐）

安装：

sudo apt install valgrind

运行：

valgrind --leak-check=full ./test_cx

可发现：

内存泄漏
越界访问

五、IDE 调试（可选）

1. VS Code（推荐）

安装插件：

C/C++
CMake Tools

launch.json 示例：

{
  "name": "Debug CxImage",
  "type": "cppdbg",
  "request": "launch",
  "program": "${workspaceFolder}/build/test_cx",
  "args": [],
  "cwd": "${workspaceFolder}",
  "MIMode": "gdb"
}

六、调试技巧总结

✅ 一定要 Debug 编译
✅ 用 gdb + valgrind
✅ 从 Load / Save / Draw 等入口函数打断点
✅ 注意 CxImage 是 非线程安全 的

如果你愿意，可以告诉我：

✅ 你用的是 哪个 CxImage 版本
✅ 是 加载失败 / 崩溃 / 编译不过
✅ 示例代码

我可以直接帮你 定位 bug 或写最小复现示例。