c-- 调试 printf管理

要让 printf 在调试时可用，而在工作时禁用，可以通过以下几种方法实现。这些方法主要依赖于条件编译或配置宏来控制 printf 的行为。

---

方法 1：使用条件编译控制 printf

通过 #define 宏控制 printf 的启用或禁用。

实现代码：

#include <stdio.h>

// 定义宏 DEBUG_MODE 控制 printf 的行为
#define DEBUG_MODE 1  // 1: 启用调试信息, 0: 禁用

#if DEBUG_MODE
    #define debug_printf printf
#else
    #define debug_printf(...) ((void)0) // 将 printf 替换为空操作
#endif

int main(void) {
    debug_printf("Debug message: This will only appear in debug mode.\n");

    // 工作模式下，debug_printf 不输出
    return 0;
}

说明：

• 使用 debug_printf 替代标准的 printf，根据 DEBUG_MODE 的值控制是否输出。
• 在工作模式下（DEBUG_MODE 为 0），所有 debug_printf 调用都不会生成输出。

---

方法 2：使用弱符号和条件重写 fputc

通过为 fputc 提供不同实现，在工作模式下让 printf 调用静默。

实现代码：

#include <stdio.h>

// 定义弱符号 fputc
__attribute__((weak)) int fputc(int ch, FILE *f) {
    // 在调试模式中输出到 UART
    return 0; // 工作模式下什么都不做
}

void DebugEnable(void) {
    // 重新定义 fputc 用于调试模式
    __attribute__((weak)) int fputc(int ch, FILE *f) {
        UART_SendByte((uint8_t)ch);  // 自定义实现
        return ch;
    }
}

int main(void) {
    printf("This message is for debug.\n");

    DebugEnable();  // 调用该函数后启用调试
    printf("Debugging enabled. This message will be sent to UART.\n");

    return 0;
}

说明：

• 在工作模式下，fputc 不会输出任何数据；在调试模式下，可以重新绑定 fputc 实现输出调试信息。

---

方法 3：使用全局开关函数

通过全局变量控制是否输出 printf。

实现代码：

#include <stdio.h>

// 全局变量控制 printf 开关
static int debug_enabled = 0;

void enable_debug(void) {
    debug_enabled = 1;
}

void disable_debug(void) {
    debug_enabled = 0;
}

// 重写 printf
int debug_printf(const char *format, ...) {
    if (!debug_enabled) {
        return 0; // 不输出
    }

    va_list args;
    va_start(args, format);
    int ret = vprintf(format, args); // 使用标准 printf 格式化输出
    va_end(args);
    return ret;
}

int main(void) {
    debug_printf("This won't be displayed.\n");

    enable_debug();  // 启用调试输出
    debug_printf("Debugging is now enabled.\n");

    disable_debug(); // 禁用调试输出
    debug_printf("This won't be displayed again.\n");

    return 0;
}

说明：

• 通过 enable_debug 和 disable_debug 函数控制调试开关。
• 所有调试信息使用 debug_printf 输出。

---

方法 4：利用编译器优化删除 printf

通过编译选项控制 printf 的生成。

实现：

在编译时添加预处理选项，如：

• 调试模式：

  gcc -DDEBUG_MODE -o app main.c
  

  等价于定义 #define DEBUG_MODE

• 工作模式：

  gcc -o app main.c
  

在代码中使用：

#ifdef DEBUG_MODE
    #define debug_printf printf
#else
    #define debug_printf(...) ((void)0)
#endif

---

方法 5：通过链接器控制 printf

在链接时不包含 printf 实现的库函数：

1. 如果使用 printf 的库文件（如 newlib），在工作模式下链接时排除相关模块。
2. 可以通过弱符号或链接选项替换 printf 的依赖。

---

---

方法 5：嵌入式开发中重定向fputc

直接将函数注释掉，fputc返回 return ch;：

int fputc(int ch, FILE *p) {

    // 调用自定义的模拟串口发送函数

    // UART_SendByte((uint8_t)ch);

    // 模拟串口中无需等待 TXE 标志位，因此省略

    // 如果模拟串口有类似机制，可以插入相关等待逻辑

    return ch;

}

推荐方法

• 小型项目：推荐 方法 1，直接用宏替换，简单有效。
• 复杂系统：推荐 方法 3，提供动态启用调试功能。
• 性能关键：推荐 方法 4，通过编译优化完全移除调试代码。

通过这些方法，可以灵活控制 printf 的行为，使调试和工作模式间的切换更加方便！