头文件应使用 #pragma once 或卫士宏防重复包含，只放声明、inline/constexpr/ 模板定义；函数实现须移至。cpp，跨平台推荐卫士宏；需配置包含路径如 -I./include；undefined reference 多因声明定义不匹配或未参与链接；依赖应精简，优先前向声明。
头文件怎么写才不会重复定义
直接上结论：用 #pragma once 或传统卫士宏，但二者有细微差别，选错会在跨平台或某些旧编译器下翻车。
常见错误是写了函数实现（比如 int add(int a, int b) {return a + b;}）放进头文件，又在多个 .cpp 里 #include 它——链接时报 multiple definition of 'add'。
- 头文件里只放声明：函数声明、
class定义、extern变量、inline函数、constexpr、模板定义 - 函数实现统一挪到对应的
.cpp文件里；实在要内联，必须加inline关键字（仅靠inline声明还不够，定义也得在头里） -
#pragma once简洁，但不是 C++ 标准，极少数嵌入式工具链不支持；卫士宏如#ifndef MY_HEADER_H更稳妥，注意命名别和系统 / 第三方头冲突（推荐加项目前缀，如MYPROJ_UTILS_H）
如何让 main.cpp 正确找到自己的头文件
路径不对，#include "my_math.h" 就会报 fatal error: my_math.h: No such file or directory，这不是语法问题，是构建路径没配对。
关键看你是用命令行还是 IDE：g++ 默认只搜系统路径和当前目录，你自己写的头放在 include/ 子目录下，就得显式告诉它：
立即学习 “C++ 免费学习笔记（深入）”；
- 命令行编译时加
-I./include（注意-I后面不能有空格） - VS 中在项目属性 → C/C++ → 常规 → 附加包含目录填
$(ProjectDir)include - CMake 里用
target_include_directories(myapp PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include) - 别用
#include <my_math.h>—— 这会让编译器去系统路径找，你的头不属于标准库
多文件工程里函数调用为什么报 undefined reference
这是链接失败，不是编译失败。现象是每个 .cpp 单独编译都过，但最后连不起来，报 undefined reference to 'calc_sum(int, int)'。
根本原因是：声明和定义没对上，或者目标文件根本没参与链接。
- 检查函数名拼写、参数类型是否完全一致（
int和const int&是不同签名） - 确认定义函数的
.cpp文件确实被编译进了最终目标（CMake 中漏了add_executable的源文件列表，或 Makefile 没列进去） - 如果函数在 A.cpp 定义、B.cpp 调用，确保 B.cpp 的头文件里有对应声明，且该头被
#include了 - 静态成员函数必须在类外定义（哪怕只有声明在头里），否则也会 undefined reference
头文件依赖混乱导致编译变慢或出错
一个头文件 #include 了 10 个其他头，而你只用其中 1 个函数——这不仅拖慢编译，还容易引发隐式依赖，比如改了某个底层头，一堆无关模块跟着重编。
解决思路是“按需包含”，不是“一股脑全 include”：
- 能用前向声明（
class Widget;）就不用#include "widget.h"，尤其在指针 / 引用参数、返回值为指针 / 引用时 - 把接口依赖和实现依赖分开：头文件里只包含真正需要的声明；具体实现用到的类型，挪到
.cpp里再 include - 用
clang -E或g++ -E预处理看实际展开内容，揪出冗余 include - 避免在头里
#include <iostream>这种重型头——除非真要流操作；输出调试信息尽量用printf或日志库替代
头文件不是越少越好，也不是越多越灵活。它本质是契约，签得清楚、守得严格，工程才不容易散架。
