将前向声明类型强制转换为void是否合法？代码合规性咨询

首先明确：你的代码不符合C++标准，MSVC2015的报错是符合标准要求的，而GCC和Clang在这里做了非标准的宽松处理。

为什么会这样？原因在于C++标准对"完整类型"的硬性要求：当你在函数定义中使用按值传递的类类型参数时，该类必须是完整类型（即已经包含类的完整定义，而非仅仅是前向声明）。哪怕你只是把参数转换为void，编译器在处理函数体时，需要确认该类型的合法性（比如拷贝构造函数是否存在、对象的内存布局等），而前向声明只告诉编译器"这个类存在"，并没有提供这些必要信息。

接下来是在保留Doxygen文档的前提下，几个靠谱的解决办法：

方案1：将参数改为引用/指针类型（推荐） #

把按值传递改为const引用（或指针），这样函数定义时只需要前向声明就足够了——因为引用/指针的大小是固定的，编译器不需要知道类的完整定义就能生成正确的代码。同时Doxygen的@param注释可以完全保留，语义也不会有变化：

namespace blah {
class SomeOtherClass; // 前向声明依然有效
}

class MyClass {
public:
    /**
     * @param copyFrom 要复制的对象
     */
    void DoSomething(const blah::SomeOtherClass& copyFrom) { // 改为const引用
        (void) copyFrom; // 现在MSVC不会报错了
    }
};

这个方案的好处是避免了不必要的头文件依赖，编译速度更快，完全符合标准。

方案2：将函数定义移到实现文件（cpp）中 #

如果你必须保留按值传递的参数类型，可以把函数的声明留在头文件（用前向声明），而把定义放到.cpp文件里，在.cpp文件中包含SomeOtherClass的完整头文件，让类型变为完整：

头文件（MyClass.h）： #

namespace blah {
class SomeOtherClass; // 前向声明
}

class MyClass {
public:
    /**
     * @param copyFrom 要复制的对象
     */
    void DoSomething(blah::SomeOtherClass copyFrom); // 仅声明
};

实现文件（MyClass.cpp）： #

#include "MyClass.h"
#include "SomeOtherClass.h" // 这里包含完整定义

void MyClass::DoSomething(blah::SomeOtherClass copyFrom) {
    (void) copyFrom; // 此时类型已经完整，编译通过
}

这样头文件里的Doxygen注释完全保留，同时代码符合标准，MSVC2015也能正常编译。

方案3：在头文件中提前包含完整类定义 #

如果不介意增加头文件依赖，可以直接在使用函数定义之前包含SomeOtherClass的头文件，让类型变为完整：

#include "SomeOtherClass.h" // 提前包含完整定义

class MyClass {
public:
    /**
     * @param copyFrom 要复制的对象
     */
    void DoSomething(blah::SomeOtherClass copyFrom) {
        (void) copyFrom; // 编译正常
    }
};

这个方案最简单，但缺点是会增加编译依赖——只要SomeOtherClass的头文件变化，所有包含MyClass.h的文件都需要重新编译，适合小型项目或依赖关系简单的场景。

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