C++报重定义的原因

最新推荐文章于 2025-05-05 09:44:16 发布
原创 最新推荐文章于 2025-05-05 09:44:16 发布 · 1.4k 阅读 · 2 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#c++

本文探讨了C++中头文件包含问题导致的函数和变量重定义，提供了修改策略：将全局变量放入对应类，函数声明与定义分离。并介绍了针对不同情况的修正方法。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

对于多个cpp文件都直接或间接包含同一个头文件时有可能会出现函数或变量重定义的情况，出现的原因具体有以下三种：（一般认为一个头文件只有一个对应的类）

1.该头文件中出现了不属于任何一个类的变量，这时会报变量重定义的错误；

2.该头文件中出现了不属于任何一个类的函数（因为这个函数不属于任何一个类，所以肯定在这个头文件中同时会有这个函数的声明与定义)，这时会报函数重定义的错误；

3.该头文件中有属于一个该头文件对应的类的函数，但这个函数紧接着在该头文件中被定义，这时会报函数重定义的错误；

对于第一种情况：将重定义的变量写入该头文件对应的类中；

对于第二种情况：将重定义的函数写入该头文件对应的类中，并且只在该头文件中对该函数进行声明而不要进行定义，而在该头文件所对应的.cpp

文件中进行定义；

ihghkb
关注
c++编译错误之--重定义默认参数
鸟哥的博客
03-03 2776
默认参数只能出现在 函数声明中。如果在函数声明和定义中同时使用了默认参数，则会出现“重定义默认参数”的错误提示 如仍有疑问 请留言 或加qq群 1032082534 ...
C++——编译报重复定义错误的解决办法
Williamcsj的博客
07-25 352
头文件被多次编译
C++ : 编程重定义错误
jekcai的博客
04-20 1944
C++ 编程重定义错误： 错误1：所编译的函数实现，已经在目标程序.obj文件中出现。错误原因：包含的头文件中出现了实现部分的代码，或者在头文件尾部包含了对应的.cpp文件。解决方法：将程序的声明和定义（实现）严格区分开，将声明存放操.h、.hpp文件中，将实现存放到.cpp文件中。因为.cpp文件是单独分开编译，如果头文件被多处引用可能导致实现部分被重复包含到不同的.cpp文件中，从而导致多重编...
C++ 类的成员函数定义在.h中为什么会产生函数重定义错误?
字节跳动 内推找我
12-27 4722
前言此篇博客来源于我在百度知道的一个回答，当时回答的不太清楚，而且追答的时候又有字数的限制，不得已决定写个博客来。问题如下 F.h: void F(){} 1.cpp: #include"F.h" void main(){F()} 2.cpp: #include"F.h" void ff(){F()} 这样会报error LNK2005的错误。但为什么连接的时候会检查重
C++中多重定义错误的解决策略
最新发布
shejizuopin的博客
05-05 690
头文件中的全局变量定义// 错误：在头文件中直接定义变量#include "error_header.h" // 链接时出现多重定义错误头文件设计原则声明与定义分离：头文件只包含声明，定义放在.cpp文件中内联函数谨慎使用：仅对性能关键的小函数使用inline模板实例化控制：显式实例化需要的模板类型代码审查清单✅ 全局变量是否使用extern声明？✅ 头文件中是否包含函数实现？✅ 模板是否在多个地方实例化？✅ 类静态成员是否正确定义？现代C++特性应用使用constexpr。
【编程训练中的问题】C++函数模板在.hpp中定义，当有多个文件包含该头文件时,编译出现重复定义
NoIdea_的博客
08-03 635
命名空间中不能定义变量。命名空间namespace ，以及重复定义的问题解析_自己定义的namespace为什么会re_晴树SEU的博客-优快云博客(21 封私信 / 81 条消息) C++函数模板在.hpp中定义和实现，当有多个文件包含该头文件时编译出现重复定义的问题，该如何解决？- 知乎 (zhihu.com)
C++编译报错：重复定义
weixin_30653023的博客
03-28 187
http://note.youdao.com/noteshare?id=cb2bed862a2daae89775603168f297af 转载于:https://www.cnblogs.com/taiyang-li/p/6637093.html
C ++ 函数在头文件中定义，结果编译时出现重定义
sinat_41686583的博客
02-23 1441
第一次定义 ，重定义
C++ Primer中&、*符号的多重定义与int *p和int* p的区别讲解
01-01
& 和*这样的符号，既能用作表达式里的运算符，也能作为声明的一部分出现，符号的上下文决定了符号的意义: int i = 42; int &r = i; //&紧随类型名出现，因此是声明的一部分，r是一个引用 int *p;...
解决C++重定义问题--匿名命名空间
神童i的博客
10-30 2181
今天遇到一个命名空间重定义的问题，程序框架大体如下： interface中定义的是一个namespace, 形式如下： namespade np { int a = 1; int b = 2; }; 并且三个module（1,2,3），以及core模块全都需要引用这个命名空间中的数据（与消息传递有关），并且这几个模块是分别编译的，最后链接起来，编译module1, module...
引发C++程序内存错误的常见原因分析与总结
dvlinker的技术专栏
01-08 2万+
系统全面地总结引发C++程序内存错误的各种原因，以供参考。
“error LNK1169: 找到一个或多个多重定义的符号”的解决方法(转载)
热门推荐
xiaosu123的专栏
06-12 2万+
<br />问题描述如下： <br />有 三个源文件，A.h、B.cpp、C.cpp。 <br />A.h是头文件，其中声明了三个变量a1、a2、 a3。 <br />B.cpp是A.h中所声明的类的实现源代码，C.cpp是主程序文件。B.cpp和C.cpp中均包含头文件 A.h。 <br />在编译时，编译能够通过，但链接时出了问题，出现”error   LNK1169:   找到一个或多个多重定义的符号“的错误。 <br />经过分析，确定了这是由于两个实现文件中重复包含了头文件而造成的。可解决方法却
c/c++多文件编译报重复定义的问题
suliangkuanjiayou的博客
12-15 3590
  相信使用微软编译器的大家（例如vs2017)肯定会遇到这样的一个问题，说你的某个变量重复定义，就像这个样子。   具体可能是代号为LNK2005和LNK1169。这个错误可能会出现在你是第一次开始使用多文件来编写程序。现在，我们就来探讨一哈这个问题。首先来介绍几个概念。   在C Primer Plus 一书中，在第12章 存储类,链接和内存管理中，有链接这样一个概念。 具有代码块作用域和...
C++头文件多次包含 变量，函数重定义解决方案
chinabinlang的专栏
01-26 8467
在C++中，最长用的编程方式是： .h：头文件中添加 变量，类等等一下对象或 函数的声明；头文件中添加宏定义 或 #pragma once(VC 中)，头文件只编译一次； .cpp：文件中添加 头文件中声明的具体实现； 然后工程中添加 h文件 和 cpp文件；（头文件可以不添加到工程中，但cpp文件不添加，编译错误）；   但是：如果我想，直接在.h头文件 中 直接实现 函数；这样的头文
hpp文件解决类成员函数重复定义的问题
morebread的专栏
07-25 7735
c++中在使用第三方开源库的时候经常会接触.hpp文件。hpp,其实质就是将.cpp的实现代码混入.h头文件当中，定义与实现都包含在同一文件，则该类的调用者只需要include该cpp文件即可，无需再 将cpp加入到project中进行编译。使用起来非常方便。 最近本人也写了个.hpp文件，跟平常一样，首先定义了一个类和各种成员函数，接着在下面实现了各种类的方法，结果在使用的时候编译器提示所有类
深入理解C++在.h头文件中定义函数导致的multiple definition
sksukai的博客
04-19 1万+
问题：某个头文件中声明并定义了一个函数，然后在多个源码文件中调用该函数，编译链接时出现了该函数multiple definition问题，在头文件中添加了 #ifndef 头也不行，经过尝试发现如果将该函数的声明和定义分开到.h和.cpp文件之后问题消失，为什么不能将函数直接定义在.h文件中呢？ 针对该问题，抽象出如下几个问题： 1头文件中只可放置函数声明，不可放置函数定义吗？ 以下面的程序为例：...
C++变量、函数在多文件中重复定义的问题
yx0225的博客
03-30 1405
在工程中包含main.cpp，head.h，head.cpp三个文件。 变量 如果在head.h中定义 int a=3; 编译会出现a重复定义的错误，解决方法目前知道三种： (1)const int a = 3; (2)extern int a; 再在head.cpp中，int a = 3; (3)删除head.cpp 函数 如果在head.h中定义 void fun() {}, 编译会出现fu...
C++基础多个.cpp文件，包含头一个.h文件 导致的重定义问题
baidu_19552787的博客
09-11 3653
myProject.h /* 头文件声明： 防止单一 一个.cpp文件 在引用头文件时 会重复包含这个头文件。 情况一：（比如a.cpp在 #include "myProject" 头文件的同时，又引入了一个 包含#include "myProject"的头文件， 在没有头文件卫士的情况下，会重复引入了myProject头文件，myProject头文件被引入了二次） 当我们加入了头文件卫士后，把它分别引入在两个不同的app文件中， myFunc1.cpp 和 myFunc2.cpp中。 在链接时 头文件中
函数命名只定义、实现了一次，却被提示早已定义
youyudexiaowangzi的专栏
04-25 843
本来为了方便管理，可以将各种模块分成各自的文件存放，只要添加进源文件，编译器会自己链接源文件，头文件用于声明，但是如果把声明和实现都放在头文件里，可能会出问题，如果只是使用一次不会发现，如果多个文件都包含该头文件，就会说早已定义，即使添加了防止重定义的宏也没用，因为实现是在这个头文件的话，依旧每个其他文件都要来找实现，于是重复定义了。 类似C:\Program Files (x86)\Micro
报重定义错误了
03-08
<think>好的，用户现在遇到了重定义错误的问题。之前我建议他们通过调整模板参数的顺序来实现函数重载，但现在他们遇到了编译错误，说明我的建议可能存在问题。我需要仔细分析用户提供的代码和可能的错误原因。 首先，用户提供的两个模板函数convertToCustom和convertFromCustom，他们想将这两个函数重命名为相同的名字convert，并通过调整模板参数的顺序来实现重载。根据之前的建议，用户可能修改了代码，但编译时报重定义错误。 我需要回顾一下C++的函数重载规则。C++中，函数重载需要不同的参数列表，而不仅仅是模板参数的名称不同。即使模板参数的顺序不同，如果实例化后的函数签名相同，编译器会视为重复定义。例如，如果两个模板函数的参数都是T和E，只是顺序不同，当用户调用时显式指定了模板参数，可能导致两个模板生成相同的函数签名，从而引发重定义错误。 例如，用户修改后的代码可能如下： template <typename TargetEnum, typename T> TargetEnum convert(T value) { ... } template <typename T, typename SourceEnum> T convert(SourceEnum value) { ... } 当用户调用convert<MyEnum>(42)时，第一个模板的TargetEnum是MyEnum，T是int。而第二个模板的T是MyEnum，SourceEnum是int。这样生成的函数签名分别是MyEnum convert(int)和MyEnum convert(int)，导致重复定义，因为两个函数的参数类型和返回类型都相同，尽管模板参数的顺序不同，但实例化后的函数签名相同，编译器无法区分。 因此，问题出在模板参数的顺序调整并没有真正改变函数签名，导致编译器无法区分两个重载函数，从而报重定义错误。这时候需要找到另一种方法让编译器能够区分这两个函数，例如通过引入额外的模板参数或使用SFINAE技术来约束模板的实例化条件。 可能正确的做法是，确保两个模板函数在实例化后的函数签名不同。例如，通过使用不同的参数类型，或者让其中一个函数接受枚举类型，另一个接受非枚举类型，从而让编译器能够区分它们。或者，使用C++20的requires子句来添加约束条件，确保两个模板不会在相同的参数下实例化。 总结起来，用户遇到的重定义错误是因为两个模板函数在实例化后生成了相同的函数签名，导致编译器无法区分。需要调整方法，确保两个重载的函数在参数类型或返回类型上有所不同，或者通过模板元编程技术来限制它们的实例化条件。</think>出现重定义错误的主要原因是**两个模板实例化后可能生成完全相同的函数签名**。以下是详细分析和解决方案： --- ### 错误原因分析 #### 原代码模板参数调整后： ```cpp template <typename E, typename T> E convert(T value) { /* T -> E */ } template <typename T, typename E> T convert(E value) { /* E -> T */ } ``` #### 冲突场景示例： ```cpp // 当用户这样调用时： auto x = convert<int, MyEnum>(value); // 两个模板都会生成： int convert(MyEnum value) ``` 两个模板实例化后生成**完全相同的函数签名**（返回类型和参数类型完全相同），导致编译器无法区分，报重复定义错误。 --- ### 解决方案 #### 方法一：添加哑模板参数（C++11起） ```cpp // 转换方向标记 template <int> struct direction {}; // T -> E 方向 template <typename E, typename T> E convert(T value, direction<0> = {}) { return EnumMapper<T>::toCustom(value); } // E -> T 方向 template <typename T, typename E> T convert(E value, direction<1> = {}) { return EnumMapper<T>::fromCustom(value); } ``` #### 使用示例： ```cpp MyEnum e = convert<MyEnum>(42); // 调用T->E int i = convert<int>(MyEnum::VALUE); // 调用E->T ``` --- #### 方法二：使用类型标签（更清晰的SFINAE） ```cpp // 类型标签定义 struct to_enum_tag {}; struct from_enum_tag {}; // T -> E 方向 template <typename E, typename T> E convert(T value, to_enum_tag = {}) { static_assert(std::is_enum_v<E>, "Target must be enum"); return EnumMapper<T>::toCustom(value); } // E -> T 方向 template <typename T, typename E> T convert(E value, from_enum_tag = {}) { static_assert(std::is_enum_v<E>, "Source must be enum"); return EnumMapper<T>::fromCustom(value); } ``` #### 使用示例： ```cpp auto e = convert<MyEnum>(42, to_enum_tag{}); auto i = convert<int>(MyEnum::VALUE, from_enum_tag{}); ``` --- #### 方法三：利用返回值类型不同（C++17起） ```cpp // T -> E 方向 template <typename E> auto convert(typename EnumMapper<E>::from_type value) { return EnumMapper<E>::toCustom(value); } // E -> T 方向 template <typename T> auto convert(typename EnumMapper<T>::to_type value) { return EnumMapper<T>::fromCustom(value); } ``` 需要类型映射器提供关联类型： ```cpp template <typename T> struct EnumMapper { using to_type = /* 对应的枚举类型 */; using from_type = /* 对应的基础类型 */; }; ``` --- ### 关键点总结 | 方案 | 优点 | 缺点 | 适用场景 | |-------------|---------------------|---------------------|---------------| | 哑模板参数 | 改动最小 | 需要额外默认参数 | 简单转换场景 | | 类型标签 | 接口自文档化 | 调用时需要传递标签对象 | 需要明确方向标识的场景 | | 返回值类型区分 | 最自然的接口 | 需要类型映射器支持关联类型 | 已有完善类型系统的项目 | | 参数类型不同 | 符合直觉 | 可能限制输入类型 | 类型有明显区分的情况 | 建议优先选择**方法二（类型标签）**，既能保持函数同名，又能通过标签明确转换方向，同时利用`static_assert`增强类型安全。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值