讲师中心 微信公众号
AI工具推荐 视频效率加速

C++编译报“redefinition of class”怎么解决

胖强姑娘_6832

胖强姑娘_6832

发布时间:2026-10-26 06:37:30

|

410人浏览过

|

来源于php中文网

原创

直接加#pragma once在头文件第一行是现代C++工程默认起点,因#include是纯文本粘贴导致类被重复定义;它比#ifndef更简洁可靠,主流编译器均支持;若仍报错需检查手动重复定义、同名类冲突或头文件混写实现。

c++编译报“redefinition of class”怎么解决

直接加 #pragma once 在头文件第一行,95% 的情况立刻解决。它不是“备选方案”,而是现代 C++ 工程的默认起点。

为什么头文件里 class 会被重定义?

根本原因是 #include 是纯文本粘贴——预处理器不管逻辑,只管把内容原样塞进去。如果 A.h 和 B.h 都 #include "Point.h",而 main.cpp 又同时 #include "A.h" 和 #include "B.h",那 Point 类定义就被粘贴了两次,编译器当场报 redefinition of 'class Point'。

这不是你写错了类名,而是同一份定义被重复展开。

  • 错误一定发生在编译期(不是链接期),所以查 .cpp 文件本身包含关系即可
  • 只要头文件没防护,哪怕只在单个 .cpp 里间接包含两次,就触发
  • 类模板、constexpr 变量、inline 函数不受此限,但普通 class 定义严格遵守 ODR

用 #pragma once 还是 #ifndef 宏守卫?

#pragma once 更简洁、不易出错,且所有主流编译器(GCC、Clang、MSVC)从 2010 年起已完全支持。它靠文件路径做唯一标识,不依赖宏名拼写,不会因宏名冲突或大小写疏忽失效。

立即学习“C++免费学习笔记(深入)”;

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

相比之下,#ifndef MYCLASS_H 虽然标准,但容易踩坑:

  • 宏名写错(比如 MYCLASS_H_ 和 MYCLASS_H 不一致)
  • 不同头文件用了相同宏名(尤其团队协作时)
  • 文件被硬链接或符号链接时,#ifndef 可能失效,#pragma once 仍可靠

除非你必须兼容极老编译器(如 GCC 3.x),否则无理由不用 #pragma once。

加了防护还是报错?检查这三处

加了 #pragma once 还报 redefinition of 'class',说明问题不在重复包含,而在别处:

  • 同一个 .cpp 文件里,手动写了两次 class X { ... }; —— 检查复制粘贴残留
  • 两个不同头文件中,都定义了同名 class X(比如都叫 Config),且都被同一个源文件包含 —— 这不是重复包含,是命名冲突,得用命名空间隔离
  • 头文件里混写了定义和实现,比如在 utils.h 中写了 void helper() { ... }(非 inline),又在多个 .cpp 里包含它 —— 这会引发链接期 multiple definition,但编译期也可能因内联展开异常报类重定义

最常被忽略的是:错误提示里的文件路径可能指向一个被其他头文件间接包含的头文件,而不是你正在编辑的那个。务必用编译器输出的完整路径定位真实源头,别只盯着当前打开的文件。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2248

2024.03.14

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

1039

2024.03.14

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

447

2024.03.14

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

327

2024.03.14

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

426

2024.03.14

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

600

2024.03.14

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

1429

2024.03.21

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

1237

2024.03.22

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Libclang tutorial
Libclang tutorial

共0课时 | 0人学习

C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn