24、__attribute__((deprecated)) 与 ((unused))：弃用警告、未使用变量抑制

各位同学，今天我们来聊两个非常实用、但很多人容易忽略的GCC扩展属性——deprecated和unused。

说实话，这两个属性在大型项目中几乎是「标配」。我最早接触它们是在维护一个十几年的嵌入式通信协议栈时，那时候代码里充斥着各种「历史遗留」函数，改也不是，删也不是。嗯，后来我找到了这两个法宝，才把局面控制住。

24.1 __attribute__((deprecated))：优雅地「退休」旧接口

先说说deprecated。它的作用很简单：标记一个函数、变量或类型为「已弃用」。当别人调用它时，编译器会给出警告。

你想想看，在团队协作中，你改了一个接口，但不敢直接删掉旧的——怕别人还在用。怎么办？我见过有人加注释「别用这个了」，但没人看。有人直接删，结果编译不过，被同事骂。

我的做法是：用deprecated。它既保留了旧接口，又让编译器替你「喊话」。

// 旧版函数，建议使用新版
__attribute__((deprecated("请使用 new_calc() 替代")))
int old_calc(int a, int b) {
    return a + b;
}

int new_calc(int a, int b, int *err) {
    *err = 0;
    return a + b;
}

int main() {
    int x = old_calc(3, 4);  // 编译时产生警告
    int err;
    int y = new_calc(3, 4, &err);
    return 0;
}

编译时你会看到类似这样的警告：

warning: 'old_calc' is deprecated: 请使用 new_calc() 替代 [-Wdeprecated-declarations]

我个人习惯在deprecated消息里写清楚「替代方案」和「计划移除的版本」。比如：

__attribute__((deprecated("将在 v3.0 移除，请改用 new_calc()")))

这样别人一看就知道该怎么做，而不是一脸懵。

24.1.1 标记枚举和类型

不只是函数，枚举值和类型也能标记。我在项目中遇到过一种情况：某个枚举值命名不准确，但已经被大量使用。直接改？所有用到的地方都得改。不改？看着难受。

typedef enum {
    STATUS_OK       = 0,
    STATUS_ERROR    = 1,
    STATUS_UNKNOWN  __attribute__((deprecated("请使用 STATUS_ERROR"))) = 2
} status_t;

这样，旧名字还能用，但编译器会提醒你「该换掉了」。过几个版本后，再彻底删除。

24.2 __attribute__((unused))：让编译器闭嘴

再说unused。这个属性用来告诉编译器：「我知道这个变量/参数没被用，但我是故意的，别警告我。」

为什么会需要这个？我举几个真实场景：

• 回调函数接口：你实现了一个回调，但某些参数你用不上。比如中断处理函数里的context参数。
• 未来扩展预留：函数参数暂时没用，但接口已经定好了，以后会用到。
• 调试开关：某些变量只在调试模式下使用，发布版本里它们就是「未使用」的。

void timer_callback(void *arg __attribute__((unused))) {
    // arg 暂时没用，但接口要求有这个参数
    printf("timer fired\n");
}

int main() {
    int debug_flag __attribute__((unused)) = 1;
    // 发布版本中 debug_flag 不会被使用
    // 但编译器不会报 warning
    return 0;
}

我曾经在一个项目中，因为没加unused，编译时冒出一堆「unused parameter」警告。几百个警告里，真正的问题被淹没了。后来我养成了习惯：只要参数是「故意不用」的，立刻加上unused。

24.3 两者结合：优雅的接口演进策略

在实际项目中，我经常把这两个属性配合使用。比如：

// 旧接口，已弃用
__attribute__((deprecated("请使用 new_init()")))
void old_init(int param1, int param2 __attribute__((unused))) {
    // param2 在旧版中未使用，但为了兼容性保留
    printf("old init: %d\n", param1);
}

// 新接口
void new_init(int param1) {
    printf("new init: %d\n", param1);
}

这样，旧接口的调用者会收到弃用警告，而旧接口内部未使用的参数也不会产生警告。干净利落。

24.4 避坑指南

讲几个我踩过的坑：

• 别滥用unused：有些人为了消除警告，把所有「暂时没用」的变量都加上unused。结果真正该删的变量被隐藏了。我的原则是：只有「明确知道以后会用」或「接口强制要求」的参数才加。
• deprecated不是银弹：它只是过渡手段。我见过一个项目，标记了deprecated的接口用了五年还没删。建议定一个时间表，比如「两个版本后移除」。
• 注意跨编译器：__attribute__是GCC和Clang的扩展，MSVC不支持。如果你需要跨平台，可以用宏封装：

#if defined(__GNUC__) || defined(__clang__)
  #define DEPRECATED(msg) __attribute__((deprecated(msg)))
  #define UNUSED          __attribute__((unused))
#elif defined(_MSC_VER)
  #define DEPRECATED(msg) __declspec(deprecated(msg))
  #define UNUSED
#else
  #define DEPRECATED(msg)
  #define UNUSED
#endif

这样，不同编译器下都能正常工作。

24.5 知识体系总览

下面这张图帮你理清这两个属性的核心逻辑：

24.6 总结

这两个属性，说白了就是「编译器级别的沟通工具」。

• deprecated帮你告诉别人：「这个别用了，用新的吧」。
• unused帮你告诉编译器：「这个没用到，但我知道，别吵」。

我在项目中一直坚持：所有公开接口的废弃，必须用deprecated标记；所有「故意不用」的参数，必须加unused。这不是矫情，而是对团队负责。你想想看，一个没有警告的编译输出，和一个满屏警告的输出，哪个更容易发现真正的问题？

好了，这一讲就到这里。记住这两个属性，它们会让你的代码更干净、更专业。

---

公众号:蓝海资料掘金营，微信deep3321