如何抑制Clang-Tidy针对自定义析构结构体的特殊成员函数警告？

针对你编写的锁管理Locker结构体遇到的警告，有以下几种可行的解决方式：

1. 明确声明所有特殊成员函数（推荐） #

Clang-Tidy的该警告核心是提醒遵循C++的三/五法则：如果自定义了析构函数，要么同时定义拷贝/移动构造和赋值，要么明确删除所有禁止的操作。你的锁管理类本身不应被拷贝或移动，因此需确保所有拷贝、移动相关的特殊成员都被明确删除：

#include <semaphore>

struct Locker {
    std::binary_semaphore* sem = nullptr;

    // 仅保留默认构造
    Locker() = default;

    // 自定义析构：自动释放锁
    ~Locker() {
        if (sem != nullptr) {
            sem->release();
        }
    }

    // 明确删除所有拷贝操作
    Locker(const Locker&) = delete;
    Locker& operator=(const Locker&) = delete;

    // 明确删除所有移动操作
    Locker(Locker&&) = delete;
    Locker& operator=(Locker&&) = delete;

    // 删除针对std::binary_semaphore的构造与赋值
    Locker(std::binary_semaphore&) = delete;
    Locker& operator=(std::binary_semaphore&) = delete;
};

明确删除所有拷贝/移动构造和赋值后，Clang-Tidy会识别到你是有意禁用这些操作，从而停止触发警告。

2. 局部或全局抑制Clang-Tidy警告 #

如果不想修改代码结构，可以直接通过Clang-Tidy的注释指令或配置文件抑制警告：

局部抑制 #

在Locker结构体上方添加注释，仅针对该类禁用警告：

// NOLINTNEXTLINE(cppcoreguidelines-special-member-functions)
struct Locker {
    // ... 你的类定义 ...
};

文件级抑制 #

在文件开头添加注释，禁用整个文件的该警告：

// NOLINT(cppcoreguidelines-special-member-functions)
#include <semaphore>

struct Locker {
    // ... 你的类定义 ...
};

配置文件全局调整 #

在项目的.clang-tidy配置文件中添加以下规则，让Clang-Tidy忽略已删除拷贝/移动操作的类的析构函数警告：

Checks: 'cppcoreguidelines-*'
CheckOptions:
  - key: cppcoreguidelines-special-member-functions.IgnoreDestructorsWithDeletedCopyMove
    value: 'true'

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