PlatformIO开发ESP32：const变量跨文件引用出现未定义引用问题

问题原因 #

C++里const修饰的变量默认是内部链接（仅当前编译单元可见）。你在file.cpp中定义的const char test[]会被编译器限定在该文件作用域内，main.cpp里的extern声明无法找到这个符号，因此链接器抛出"Undefined Reference to test"错误。

解决方案 #

有两种可行的修复方式：

方式1：给定义的const变量添加extern关键字 #

修改file.cpp的代码，在const数组定义前加上extern，将其改为外部链接，允许其他编译单元访问：

// file.cpp
extern const char test[] = {1,2,3};

main.cpp代码保持不变即可：

// main.cpp
extern const char test[];

int main() {
   char buff[10];
   strcpy(buff, (char *) test);
   return 0;
}

方式2：使用头文件统一声明（更规范） #

1. 创建头文件file.h，在其中声明extern的const数组：

// file.h
#ifndef FILE_H
#define FILE_H

extern const char test[];

#endif

2. 在main.cpp和file.cpp中都包含这个头文件：

// main.cpp
#include "file.h"

int main() {
   char buff[10];
   strcpy(buff, (char *) test);
   return 0;
}

// file.cpp
#include "file.h"

const char test[] = {1,2,3};

这种方式能避免重复声明问题，也更贴合大型项目的代码规范。

补充说明 #

同一文件内定义和使用const数组正常运行，是因为此时变量的内部链接作用域覆盖了整个编译单元，编译器能直接找到符号，无需跨文件链接。

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