C++编译报错：has initializer but incomplete type 问题咨询

错误根源 #

你的main.cpp仅包含Util.hpp，而该头文件里只有Contact的前向声明（struct Contact;和冗余的using Contact = struct Contact;），没有提供结构体的完整定义。

编译器编译main.cpp时，仅知道Contact是一个结构体类型，但完全不清楚它的成员变量、内存布局等细节。而你在main函数中尝试直接初始化Contact对象，这要求编译器必须知道类型的完整信息才能分配内存、映射初始化值到成员变量——这种矛盾就触发了“has initializer but incomplete type”错误。

另外你把Contact的完整定义放在Util.cpp里是无效的：源文件（.cpp）是单独编译的单元，main.cpp的编译过程不会读取Util.cpp的内容，所以其他文件无法获取到这个完整定义。

解决方法 #

将Contact的完整定义移到Util.hpp中，确保所有包含该头文件的源文件都能获取到完整类型信息：

#ifndef __UTIL__
#define __UTIL__
#include <string> // 必须包含std::string的头文件，否则会引发额外编译错误

struct Contact
{
    std::string fistname;
    std::string lastname;
    int age;
    std::string number;
};
#endif

同时删除Util.cpp中重复的Contact结构体定义，避免出现“重复定义”的编译错误。

补充说明 #

C++中，前向声明仅适用于以下场景：

• 声明指向该类型的指针或引用
• 将该类型作为函数的参数类型或返回类型（仅声明函数，不实现）

一旦需要创建该类型的对象、访问其成员变量或调用成员函数，必须提供类型的完整定义。

内容的提问来源于stack exchange，提问作者Souleymane Diomandé