在代码中注释 printf() 语句

Question

最近，在处理大量代码时，我观察到有时添加一些额外的 printf() 语句并对其进行注释对于在必须修改代码时的后期调试(使其更容易)非常有用。但是关于过度注释代码和缺少适当的注释存在争论。我不确定这种做法在哪里？另外，我发现这种注释方式的一个缺点是它使代码看起来更难看。这是一个例子:

 ...... //code ......  pkt_bytes_decd = avcodec_decode_audio4( aCodecContext, pFrame,                                          &frame_fin, &packet );
 //printf("%d bytes from packet decoded\n",pkt_bytes_decd); ......  ...... //code

这是一种不好的做法吗？有人可以根据他们的经验讨论利弊吗？

Answer 1

使用一些依赖于启用或禁用调试标志的宏会更干净。

这样，您无需取消任何注释即可进行调试。只需启用调试标志，它就会立即在所有这些地方启用日志记录。

有时会使用另一种方法 - 调用像 log(level, message) 这样的函数，只有当级别高于设定阈值时它才会发出消息(通常称为错误、警告、信息等) .它效率不高，但使调试更容易。