C++17中extern修饰结构体报错，如何让结构体跨cpp文件可见

代码报错的核心原因 #

你踩的是C++跨文件编译的几个经典语法误区：

• 给结构体定义加extern修饰本身就是语法错误：extern只能用来标记变量、函数的外部链接属性，根本不能用于结构体、类这类类型定义，这就是你看到“存储类只能为对象和函数指定”报错的直接来源。
• other.cpp里的extern abc;属于无意义语法：abc是自定义类型，不是变量/函数，加extern没有任何作用；而且other.cpp编译时完全看不到main.cpp里的abc结构体定义，根本不知道这个标识符代表什么。
• 你想共享的带初始值的全局数组，必须遵循C++的ODR（单一定义规则）：同一个全局实体，只能在一个源文件里做正式定义，其他文件里只能做extern声明，不能重复写定义。

可直接复用的最简实现方案 #

你自己摸索到的“把结构体定义放头文件”的方向是完全正确的，只需要按照“类型定义抽头、全局实例分离声明定义”的规则调整即可，不需要复杂语法。

步骤1：新建公共头文件common.h #

把所有跨文件共享的内容（结构体定义、全局实例声明、公共函数声明）放在这里，加头文件保护防止重复包含：

// common.h
#ifndef COMMON_H
#define COMMON_H

#include <string>  // 结构体用到std::string，必须包含对应头

// 直接定义结构体，不要加extern
struct abc
{
    int a;
    std::string bla_bla;
};

// 用extern声明全局数组实例，仅做语法提示、不分配实际内存
extern abc put[2];

// 声明公共函数签名
void display(abc (&)[2]);

#endif

步骤2：调整main.cpp #

在这里真正定义带初始值的全局实例，全项目链接时可被其他文件访问：

// main.cpp
#include <iostream>
#include "common.h"

// 这里是put数组的实体定义，实际分配内存、写入初始值
abc put[2] = {
    {10, "Apple"},
    {20, "Ball"}
};

int main()
{
    display(put);
    return 0;
}

步骤3：调整other.cpp #

引入公共头，直接实现对应的函数即可，不需要重复写结构体、实例的定义：

// other.cpp
#include <iostream>
#include "common.h"

void display(abc (&put)[2])
{
    std::cout << put[0].a << '\t' << put[0].bla_bla << std::endl;
    std::cout << put[1].a << '\t' << put[1].bla_bla << std::endl;
}

新手易踩的避坑提示 #

• 绝对不要把带初始值的全局变量定义直接写在头文件里：否则每个包含该头的源文件都会生成一份独立的变量实体，链接阶段会报“重复定义”错误。
• 编译时需要把所有源文件一起传给编译器，例如C17标准下的g编译命令为 g++ -std=c++17 main.cpp other.cpp -o demo，单独编译单个文件会触发链接错误。
• 头文件保护（开头的#ifndef、#define、#endif三行）不要省略：否则同一个源文件多次包含该头时，会触发“结构体重复定义”的编译错误。

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