找到一个或多个多重定义的符号的问题

一、问题描述

当一个变量或者函数在头文件定义时,如果被多个源文件包含,就会出现连接错误:error LNK2005: "..." ...已经在 ... 中定义 和fatal error LNK1169: 找到一个或多个多重定义的符号,原因是这个头文件在多个源文件中展开,从而导致了重定义。

  • 头文件定义变量时发生此错误:
  • 头文件定义函数时发生此错误:

二、解决方法:

  • 解决头文件定义变量时发生此错误:

1.在头文件中用 extern 声明变量,然后定义它并选择性地在唯一的源文件中进行初始化。 此变量现在是全局变量,可通过将其声明为 extern(例如,通过包含头文件)在任何源文件中使用。 对于必须是全局变量的变量,建议使用此解决方案,但良好的软件工程做法可以最大程度地减少全局变量。

2.将变量声明为 static。 这将定义的范围限制为当前对象文件,并允许多个对象文件拥有自己的变量副本。 不建议在头文件中定义静态变量,因为可能会与全局变量混淆。 建议将静态变量定义移动到使用它的源文件。

  • 解决头文件定义函数时发生此错误:

1.将函数声明和定义分离

2.将函数定义成静态函数,因为静态函数的链接属性,只在当前文件可见

3.将函数定义成内联函数

参考:

链接器工具错误 LNK2005 | Microsoft Learn

相关推荐
沫璃染墨11 分钟前
《从零入门Linux系统篇(五十四):线程篇·七——互斥锁底层原理:从原子交换到线程竞争与锁实现》
linux·运维·服务器·开发语言·c++·驱动开发·系统架构
可乐ea2 小时前
GitHub Security Lab 开源 Fuzzing Taskflow:让 LLM 智能体自己跑完 C/C++ 模糊测试
jvm·c++·github·模糊测试·mcp·代码agent·智能体自动化
朝朝辞暮i2 小时前
C++ 第 13 课:值传递 —— 为什么函数里改了,外面却没变?
java·c++·算法
无忧.芙桃3 小时前
C++语言原理与实践(十):vector类的底层实现
开发语言·c++·算法
无名猿3 小时前
std::variant 完全指南:类型安全的 union 与 std::visit 用法
c++·stl·标准库·现代c++
无名猿4 小时前
C++ 迭代器五分类与失效场景汇总:一张表避开所有 UB
c++·stl·标准库·踩坑记录
0+1114 小时前
算法 --模拟
c++·算法·leetcode
hetao17338374 小时前
2026-10-01~02 hetao1733837 的刷题记录
c++·算法
郝学胜-神的一滴5 小时前
AI 编程智能体 03:拆解当下主流智能体能力
开发语言·c++·人工智能·python·程序人生·游戏
宵时待雨6 小时前
linux笔记归纳25:多路转接epoll
linux·服务器·网络·c++