如何消除C++项目中modernize-deprecated-headers与misc-include-cleaner警告？

问题根源 #

open_memstream是POSIX标准扩展函数，不属于C++标准库规定的<cstdio>内容，因此：

• 引入<cstdio>时，clang-tidy的misc-include-cleaner检测不到该函数的直接声明，触发警告；
• 改用C头文件<stdio.h>时，modernize-deprecated-headers又会警告使用了废弃的C风格头文件。

解决方案（不屏蔽任何警告） #

方法1：包含<cstdio>并手动声明POSIX函数

在包含<cstdio>后，显式声明open_memstream函数（用extern "C"包裹，匹配该函数的C风格实现）：

// 定义POSIX宏（部分环境需要，确保函数声明合法）
#define _POSIX_C_SOURCE 200809L

#include <cstdio>

// 显式声明open_memstream
extern "C" {
FILE* open_memstream(char** bufp, size_t* sizep);
}

// 正常使用函数
void example() {
    char* buffer = nullptr;
    size_t buf_size = 0;
    FILE* stream = open_memstream(&buffer, &buf_size);
    
    // 操作流逻辑...
    
    fclose(stream);
    free(buffer); // 注意：open_memstream分配的内存需用free释放
}

这样既符合C++标准头文件的使用规范，又让misc-include-cleaner识别到函数已被显式声明，不会触发警告。

方法2：配置编译宏以启用标准库扩展

部分标准库（如GNU libc）在定义正确的POSIX宏后，会将open_memstream的声明导入到std命名空间中。可以通过编译选项添加宏定义（比如-D_POSIX_C_SOURCE=200809L），此时仅包含<cstdio>即可使用std::open_memstream，同时满足两个检查：

#include <cstdio>

void example() {
    char* buffer = nullptr;
    size_t buf_size = 0;
    FILE* stream = std::open_memstream(&buffer, &buf_size);
    
    // 操作流逻辑...
    
    std::fclose(stream);
    free(buffer);
}

这种方式更简洁，但依赖标准库的实现，需要确认你的编译环境支持该扩展。

内容的提问来源于stack exchange，提问作者DeZe