直接加#pragma once在头文件第一行是现代c++工程默认起点，因#include是纯文本粘贴导致类被重复定义；它比#ifndef更简洁可靠，主流编译器均支持；若仍报错需检查手动重复定义、同名类冲突或头文件混写实现。
直接加 #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 年起已完全支持。它靠文件路径做唯一标识，不依赖宏名拼写，不会因宏名冲突或大小写疏忽失效。
相比之下，#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，但编译期也可能因内联展开异常报类重定义
最常被忽略的是：错误提示里的文件路径可能指向一个被其他头文件间接包含的头文件，而不是你正在编辑的那个。务必用编译器输出的完整路径定位真实源头，别只盯着当前打开的文件。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
