头文件只声明不定义，源文件必须包含对应头文件；头文件禁放变量/函数定义（const/constexpr/inline/模板除外），需用守卫宏防重复包含；依赖尽量前置声明，减少编译耦合。
头文件只负责“说清楚有什么”，源文件只负责“把事情做完”。任何在头文件里写函数体、变量定义、using namespace，或者在源文件里漏掉对应头文件的#include，都会直接导致编译失败或链接错误。
头文件里只能放声明，不能放定义
声明告诉编译器“这个东西存在、长什么样”，定义则真正分配内存或生成代码。头文件被多个.cpp包含，如果里面写了int global_count = 0;或void helper() { ... }，每个编译单元都会生成一份，链接时就会报multiple definition of 'global_count'。
- 允许写：函数声明（
int add(int a, int b);）、类定义（含成员函数声明）、extern变量声明、const/constexpr变量、模板定义、内联函数（inline）、宏（#define PI 3.14） - 禁止写：非
const全局变量定义、普通函数实现、static函数体（除非明确只在本头文件用）、using namespace std; - 例外：模板和
inline函数必须定义在头文件里，因为编译器需要看到完整代码才能实例化
源文件必须#include对应的头文件
这不是可选项，是强制要求。源文件math_utils.cpp实现add()，就必须第一行写#include "math_utils.h"。否则编译器在编译该.cpp时，根本不知道add()的签名，会报no declaration of 'add' in this scope。
- 这么做能保证声明与定义严格一致：比如头文件声明
int add(int, int)，源文件却写double add(float, float)，编译器立刻报错 - 避免手写声明出错：不依赖记忆或复制粘贴，所有接口以头文件为唯一权威来源
- 头文件中用到的其他类型（如
std::string），应在头文件里#include <string></string>；源文件只需包含自己的头文件，不必重复包含标准库
头文件必须加保护，但别乱用#pragma once
#ifndef/#define/#endif是跨编译器安全的守卫方式；#pragma once虽简洁，但在某些老旧构建系统或符号链接场景下可能失效，尤其当同一头文件通过不同路径被包含时。
- 守卫宏名要唯一：推荐
PROJECT_MODULE_FILENAME_H_格式，比如NETWORK_HTTP_CLIENT_H_，避免HTTP_H这种泛化命名 - 不要在头文件里
#include无关头文件：比如user.h里不需要#include "database.h"，除非它真用到了DatabaseConnection的实体对象（而不仅是DatabaseConnection*） - 指针/引用场景优先用前置声明：在
user.h里写class DatabaseConnection;就够了，把#include "database.h"挪到user.cpp里，能显著减少头文件依赖链
一个头文件通常配一个源文件，但不是绝对
一对一是最清晰、最易维护的组织方式，但工程中常有例外：
- 纯接口类（只有
virtual函数）可以只有.h，没有.cpp，比如抽象基类Shape - 模板库（如
vector.h）几乎全是头文件，不设.cpp - 小型工具函数集合（
string_utils.h+string_utils.cpp）适合合并，但若函数全是inline或constexpr，也可全放在头文件里 -
main.cpp不对应任何头文件，这是正常情况
真正容易被忽略的是：头文件里的每一个#include，都让它的“污染半径”扩大一圈——只要被包含的头文件一改，所有间接包含它的.cpp都要重编译。控制依赖，比写功能更早决定项目后期的编译速度。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
