Ascend C算子调试实战：CPU域的2种高效调试方法

在Ascend C算子开发中，“调试”是让算子从“代码”变为“可用功能”的关键环节。而CPU域调试是算子开发的“第一站”——它无需依赖NPU硬件，能快速验证算子的逻辑正确性，大幅降低开发成本。

一、CPU域调试的价值：为什么先在CPU上调试？

在Ascend C算子开发流程中，CPU域调试是“前置验证环节”，其核心价值在于：

1. 成本低：无需部署NPU硬件环境，仅需普通的CPU开发机即可完成；

2. 效率高：能快速验证算子的逻辑正确性（如变量计算、Tensor维度等），避免将基础逻辑问题带入NPU域；

3. 易上手：依赖`printf`、GDB等通用调试工具，开发者无需学习新的调试组件。

 二、方法1：“简单粗暴”的printf——快速验证数值正确性

如果仅需验证“变量或Tensor的数值是否符合预期”，`printf`是最直接、高效的调试手段。Ascend C支持在CPU域中直接使用`printf`，同时提供了`LocalTensor`的专用打印接口。

 1. 打印标量变量

在算子代码中，直接插入`printf`语句，即可输出标量变量的数值。

示例场景：验证`LocalTensor`的尺寸是否正确。

假设我们定义了一个`LocalTensor`：

```c

LocalTensor<float> local = LocalTensor<float>::Create({4, 4}, "local");

此时可通过printf打印其尺寸信息：

输出结果：

 通过输出结果，可快速验证 LocalTensor 的维度是否符合“4×4”的预期。

2. 打印LocalTensor的数值

对于 LocalTensor 的数值验证，Ascend C提供了 Local::Print() 接口，可直接打印 LocalTensor 的元素数据。

接口说明：

-  Local::Print() ：每行打印256字节的数据（避免输出过长）；

- 支持所有常见数据类型（如float、int32等）。

示例场景：验证 LocalTensor 的初始化数值是否正确。

假设我们对 LocalTensor 进行初始化：

 此时调用Print（）接口：

 输出结果：

 通过输出结果，可验证 LocalTensor 的初始化逻辑是否正确。

printf调试的适用场景：

快速验证变量、Tensor的尺寸或数值；

定位“数值计算错误”“维度不匹配”等基础问题；

适合开发初期的快速验证，不适合复杂逻辑的定位。

三、方法2：“精细定位”的GDB——单步跟踪代码逻辑

当算子出现“逻辑错误”（如循环次数错误、条件判断异常）时，仅靠 printf 无法定位问题，此时需要使用GDB进行单步调试，跟踪代码的执行流程。

但需要注意：Ascend C的CPU域模拟了NPU的多核架构——在Atlas系列产品（如Atlas 800I A2）中，每个核会拉起一个独立的子进程。因此，在GDB调试时，需设置“跟踪子进程”，才能正确调试每个核的代码逻辑。

GDB调试的完整步骤

以下以“自定义加法算子（add_custom.cpp）”为例，讲解GDB调试的具体流程。

步骤1：编译代码时添加调试信息

在编译算子代码时，需添加 -g 参数，生成包含调试信息的可执行文件：

 其中：

-g ：添加调试信息；

-lascendcl ：链接Ascend CL库。

步骤2：启动GDB并配置多进程跟踪

由于Ascend C在CPU域模拟了多核架构，每个核对应一个子进程，因此需设置GDB跟踪子进程：

 步骤3：设置断点并单步调试

断点是GDB调试的核心——通过在关键代码行设置断点，可暂停程序执行，查看变量状态、代码流程等信息。

示例操作：

假设 add_custom.cpp 的核心逻辑如下：

 我们需要验证“加法计算的逻辑是否正确”，可按以下步骤调试：

1. 在第45行（初始化循环）设置断点： 2. 运行程序，触发断点：

3. 查看变量 i 的初始值：

 4. 单步执行循环，查看 a[i] 和 b[i] 的赋值：

 5. 在第50行（加法计算）设置断点，验证计算结果：

 GDB调试的适用场景：

定位复杂的逻辑错误（如循环次数、条件判断、变量赋值异常）；

跟踪代码的执行流程，理解算子的运行逻辑；

适合开发中期的精细调试，补充 printf 的不足。

四、CPU域调试的最佳实践

在实际开发中，建议结合两种调试方法：

1. 开发初期：用 printf 快速验证变量、Tensor的尺寸与数值，排除基础问题；

2. 开发中期：用GDB单步调试复杂逻辑，定位代码执行流程中的异常；

3. 调试完成后：删除 printf 语句，重新编译代码（避免调试信息影响性能）。

2025年昇腾CANN训练营第二季，基于CANN开源开放全场景，推出0基础入门系列、码力全开特辑、开发者案例等专题课程，助力不同阶段开发者快速提升算子开发技能。获得Ascend C算子中级认证，即可领取精美证书，完成社区任务更有机会赢取华为手机，平板、开发板等大奖。​

报名链接:https://www.hiascend.com/developer/activities/cann20252