debian如何调试cximage代码

在 Debian 上调试 CxImage（一个 C++ 图像处理库）通常包含几个关键环节：编译带调试信息的库/程序、使用 GDB 或 IDE 调试、定位常见问题。下面按实战流程说明。

一、准备调试环境（Debian）

1. 安装基础工具

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

2. 获取 CxImage 源码

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

注意：不同 CxImage 版本结构略有差异，有些是 .dsp/.vcxproj，在 Linux 下一般手动写 Makefile 或 CMake。

二、编译 CxImage（带调试符号）

方法一：手动 g++ 编译（推荐调试用）

g++ -g -O0 -I. -I./CxImage \
    your_test.cpp \
    CxImage/*.cpp \
    jpeg/*.cpp \
    png/*.cpp \
    zlib/*.cpp \
    -o test_cx

参数说明：

• -g：生成调试信息
• -O0：关闭优化（否则变量可能被优化掉）
• -I：包含头文件路径

方法二：CMake（如果存在）

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
make

三、使用 GDB 调试 CxImage 代码

1. 启动 GDB

gdb ./test_cx

2. 常用调试命令

break main
run
next
step
print img
backtrace

示例断点：

break CxImage::Load
break CxImage::Create

四、调试 CxImage 常见问题

1. 加载图片失败（返回 false）

CxImage image;
bool ok = image.Load("test.jpg", CXIMAGE_FORMAT_JPG);

调试方式：

print ok
step into Load

常见原因：

• 文件路径不对
• 没有编译对应格式支持（JPG/PNG）
• 编码问题（Windows ↔ Linux 路径）

2. 图像为空 / 崩溃

检查：

if (!image.IsValid()) {
    printf("invalid image\n");
}

GDB 中：

print image.head
print image.pDib

3. 内存问题（段错误）

使用：

gdb ./test_cx
run
bt

或更高级：

sudo apt install valgrind
valgrind ./test_cx

五、在 VS Code 中调试（推荐）

1. 安装插件

• C/C++
• CMake Tools（可选）

2. launch.json 示例

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

六、调试技巧总结

✅ 一定要：

• -g -O0
• 用 GDB 单步
• 检查 IsValid()
• 用 Valgrind 查内存

❌ 避免：

• Release 模式调试
• 混用不同 CxImage 版本
• 忽略返回 false

如果你愿意，可以：

• 贴出 具体 CxImage 代码
• 或说明 卡在哪一步（加载 / 转换 / 保存）

我可以直接帮你定位问题。