搭建自己的Debug Center（一）

我的开发组长曾经说过这么一段话“一个优秀的程序员不在于他写代码有多快，也不在于他能不能实现这个模块的功能，要实现业务实现功能谁不会啊，重要的是他的解决能力，也就说当程序出现错误时你能不能够快速定位到错误并解决它。”

是的，我也非常赞同，代码不可能完美，也可能有千奇百怪的bug，尤其是新手，犯的错误就更多了，所以，我们写程序时应有自己的一套debug手段，一旦程序发生错误，我们不需要再往程序中加繁琐的打印就可以定位到错误位置，这样才能加快自己的开发速度。

那这个Debug Center怎么搭建呢？我的想法是这样：

• 进程内开一个独立线程用于Debug&Info Center，在这里我们可以看到所有的打印信息，便于追踪各线程动向
• 标准化一套日志/打印的手段，不要再使用简陋的printf
  

今天我们先来完成自定义一套我们Debug Center的规矩。那规矩有哪些呢？

一、信息类别与等级

我们知道，程序内可能出现各种异常，有的异常很严重，一不注意就发生coredump；有的异常只是可能对程序的运行产生影响，但不至于挂掉；有的异常是隐蔽的，虽说现在没对系统产生明显影响，但是不加处理也终究是个隐患。如果我们对这些异常都使用printf语句的话，我们就区分不了哪些异常重要哪些不重要了，所以我们首先得给信息分类别评等级（severity）。我的划分是这样的：

1. fatal         致命错误
2. alarm         需要立即纠正的错误
3. error         需要关注的错误
4. warning       警告，可能存在某种差错
5. info          一般提示信息
6. debug         调试信息 

代码定义可以这么写：

#define FATAL      1
#define ALARM      2
#define ERROR      3
#define WARN       4
#define INFO       5
#define DEBUG      6

要想这六类信息的log输出首先得打开其在系统中的开关，那我们怎么设计这类开关呢？下一篇文章会详细解析。

二、log的设计

根据我们上面规定的打印等级，我们很容易设计出相应的debug log，闲话少说，先上代码：

#define MY_LOG(level, fmt, args...)  do{  \
    if(BIT_ON(debug_flag,level)){  \
        printf("[%s]:", __FUNCTION__); \
        printf(fmt, ##args); \
    }  \
}while(0)

使用方法：

if(pthread_create(&thread2_id, NULL, (void*)msg_sender2, NULL))
{
    MY_LOG(FATAL,"create handler thread fail!\n");
    return -1;
 }


MY_LOG(DEBUG,"I have recieved a message!\n");
MY_LOG(DEBUG,"msgtype:%d   msg_src:%d  dst:%d\n\n",msg->hdr.msg_type,msg->hdr.msg_src,msg->hdr.msg_dst);

当然使用前需要先打开相应的log开关，比如我想看debug的log，可以这么做：

SET_BIT(debug_flag, DEBUG);

再说一个打印的小技巧：给你的打印上颜色！

printf("\033[46;31m[%s:%d]\033[0m "#fmt" errno=%d, %m\r\n", __func__, __LINE__, ##args, errno, errno);

上面printf时在Linux命令行下打印出带颜色的字体，方便一眼区分不同种类的调试信息，只需要加上一些颜色代码，例如：这里的46代表底色, 31代表字体的颜色。

使用ascii code 是对颜色调用的始末格式如下：

\033[ ; m …… \033[0m

后面哪个 ”\033[0m” 是对前面哪个颜色载入的结束，恢复到终端原来的背景色和字体色，可以把后面哪个修改成如下试试：

#define DEBUG_ERR(fmt, args...) printf("\033[46;31m[%s:%d]\033[40;37m "#fmt" errno=%d, %m\r\n", __func__, __LINE__, ##args, errno, errno);

下面列出 ascii code 的颜色值：

    字背景颜色范围:40----49                            字颜色:30-----------39

         40:黑                                            30:黑

         41:深红                                          31:红

         42:绿                                            32:绿

         43:黄色                                          33:黄

         44:蓝色                                          34:蓝色

         45:紫色                                          35:紫色

         46:深绿                                          36:深绿

         47:白色                                          37:白色

记忆颜色格式太麻烦了，我们将它搞成宏定义吧，这样以后用起来就方便得多。

#define NONE                 "\e[0m"
#define BLACK                "\e[0;30m"
#define L_BLACK              "\e[1;30m"
#define RED                  "\e[0;31m"
#define L_RED                "\e[1;31m"
#define GREEN                "\e[0;32m"
#define L_GREEN              "\e[1;32m"
#define BROWN                "\e[0;33m"
#define YELLOW               "\e[1;33m"
#define BLUE                 "\e[0;34m"
#define L_BLUE               "\e[1;34m"
#define PURPLE               "\e[0;35m"
#define L_PURPLE             "\e[1;35m"
#define CYAN                 "\e[0;36m"
#define L_CYAN               "\e[1;36m"
#define GRAY                 "\e[0;37m"
#define WHITE                "\e[1;37m"

#define BOLD                 "\e[1m"
#define UNDERLINE            "\e[4m"
#define BLINK                "\e[5m"
#define REVERSE              "\e[7m"
#define HIDE                 "\e[8m"
#define CLEAR                "\e[2J"
#define CLRLINE              "\r\e[K" //or "\e[1K\r"


#define DEBUG_ERROR(fmt, args...) do{  \
    printf(RED"[%s]:"NONE, __FUNCTION__);  \
    printf(fmt, ##args);  \
    }while(0);

效果：

所以，我建议将fatal一类致命错误级别的log用红颜色标注，一旦有这类错误发生我们也能第一时间察觉。

那当程序跑起来时我想看其他级别的log该怎么办？不是说好的不修改程序就可调试定位错误的吗？不急，下篇文章我们就实现它！