我一眼就定位到你问题的核心了——你在Main.cpp里直接#include了ObjectHandler.cpp源文件，这是C++开发里非常典型的错误，直接触发了双重定义的链接错误。

为什么会出现这个错误？ #

当预处理器处理#include "ObjectHandler.cpp"时，它会把ObjectHandler.cpp里的所有内容原封不动地复制到Main.cpp中。这就导致：

• 编译Main.cpp时，里面包含了pixels、sprites这些全局变量，以及pixelsInit()等函数的定义，生成Main.obj时这些符号已经存在
• ObjectHandler.cpp本身也会被单独编译成ObjectHandler.obj，里面同样有这些全局变量和函数的定义
• 链接阶段，编译器发现两个.obj文件里都有相同的符号定义，就抛出了LNK2005错误

你提到自己的#include结构是“线性的”，但直接包含源文件打破了头文件-源文件的正确分离规则，才引发了问题。

正确的修复方案（分三步） #

我们需要把声明和定义分离：用头文件（.h）存放声明，源文件（.cpp）存放实际的定义，然后在需要使用的地方包含头文件。

1. 创建ObjectHandler.h头文件

这个文件用来存放全局变量的声明和函数的声明，告诉编译器这些符号的存在：

#pragma once
#include "ComplexTypes.h"
#include <string>
#include <map>
#include <vector>

// 用extern声明全局变量（仅告诉编译器变量存在，不定义）
extern std::vector<pixel> pixels;
extern std::map<std::string, sprite> sprites;

// 声明函数（无需函数体，仅告诉编译器函数的签名）
void pixelsInit();
void spritesInit();
void pixelsUpdate();
void spritesUpdate();

2. 修改ObjectHandler.cpp源文件

在这个文件里包含新的头文件，并实现函数、定义全局变量（这里是唯一的定义位置）：

#include "ObjectHandler.h"

// 全局变量的实际定义（仅在这里定义一次）
std::vector<pixel> pixels;
std::map<std::string, sprite> sprites;

// 函数的实现
void pixelsInit(){}
void spritesInit(){}
void pixelsUpdate(){}
void spritesUpdate(){}

3. 修改Main.cpp

现在只需要包含头文件，而不是源文件：

#include "ObjectHandler.h"  // 替换原来的#include "ObjectHandler.cpp"

int main() {
 pixelsInit();
 spritesInit();
 while (true) {
 pixelsUpdate();
 spritesUpdate();
 };
 return 0;
}

额外说明 #

• #pragma once的作用是防止头文件被多次包含，确保头内容不会被重复复制到多个源文件中，避免不必要的编译问题
• extern关键字是关键：它让编译器知道“这个变量在别的文件里定义了，我只是用它”，而不是在这里重新定义
• 永远不要直接#include源文件（.cpp），源文件应该只被编译器编译一次，头文件才是用来共享接口的载体

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