使用CMake构建C++项目时出现多重定义链接报错如何解决？

核心问题 #

你对变量声明和定义的认知存在偏差：test.h中的int b;、patata _patata;属于变量定义，不是声明。
头文件守卫（#pragma once/#ifndef TEST_H）仅能避免同一个.cpp文件重复引入同一份头文件导致的符号冲突，无法阻止多个不同的.cpp文件引入头文件后，各自生成独立的全局变量实例。你的项目中main.cpp和test.cpp都引入了test.h，两个编译单元生成的目标文件中都存在b和_patata的符号，链接时就会触发多重定义错误。

你的CMake配置没有问题，所有.cpp文件加入编译规则的认知也是正确的，并非test.cpp被重复编译导致的问题。

解决方案 #

可根据你的实际需求选择任意一种：

方案1：头文件仅做声明，变量定义放到.cpp中 #

这是最通用的全局变量使用方式：

1. 修改test.h中的变量为extern声明，不做定义：

#pragma once
#ifndef TEST_H
#define TEST_H

#include <string>
#include <gui/patata.h>

extern int b;
extern patata _patata;
std::string message();
#endif

2. 在任意一个.cpp文件中补充变量定义，建议放到test.cpp中：

// test.cpp 头部添加定义
int b;
patata _patata;

方案2：使用C++17 inline变量 #

你的项目已经配置了C++17标准，可直接将头文件中的变量定义为inline，链接器会自动合并所有编译单元的同个inline变量为唯一实例：

// test.h 修改
inline int b;
inline patata _patata;

方案3：变量设为静态（仅适用于不需要跨文件共享的场景） #

如果这两个变量不需要在多个.cpp中共享值，可在定义时加static关键字，每个引入头文件的编译单元会生成独立的变量实例，不会触发链接冲突：

// test.h 修改
static int b;
static patata _patata;

该方式会产生多份变量副本，不推荐用于需要全局共享的场景。

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