答案：C++头文件应使用头文件保护（如#pragma once或宏定义）防止重复包含，仅包含声明而非定义，合理使用前置声明减少依赖，按规则顺序包含必要头文件，避免using指令污染全局命名空间，模板和内联函数可定义在头文件中，并添加清晰注释以提升可维护性。
在C++中，头文件（.h 或 .hpp）用于声明函数、类、变量、模板等，使得多个源文件可以共享这些声明。正确编写头文件不仅能避免编译错误，还能提升代码的可维护性和可重用性。以下是C++头文件的编写规范和最佳实践。
1. 使用头文件保护（Header Guards）
防止头文件被多次包含是编写头文件的首要原则。使用宏定义或#pragma once都可以实现，推荐使用两者之一，但不建议混用。
示例（推荐方式）：
#ifndef MYCLASS_H #define MYCLASS_H// 头文件内容
立即学习“C++免费学习笔记（深入）”；
endif // MYCLASS_H
或使用更现代简洁的方式：
#pragma once// 头文件内容
立即学习“C++免费学习笔记（深入）”；
说明： #pragma once被主流编译器支持，写法简单且不易出错，但在极少数情况下可能有兼容性问题。传统宏保护则更通用。
2. 只在头文件中放置声明，而非定义
头文件应只包含声明（declarations），如函数原型、类定义、extern变量声明等。避免在头文件中进行变量定义或函数实现（除非内联函数、模板等特殊情况）。
- 函数声明： void printMessage();
- 类定义：允许完整定义，因为类本身是声明
- 变量：使用 extern int global_count; 声明，定义放在.cpp中
- 避免：int global_count = 0;（会导致多重定义错误）
3. 合理使用前置声明（Forward Declarations）
当头文件中不需要完整类型时（如仅使用指针或引用），使用前置声明代替包含整个头文件，可减少编译依赖，加快编译速度。
示例：
class MyClass; // 前置声明void process(const MyClass* obj);
注意： 如果需要访问类成员或继承，则必须包含对应头文件。
4. 包含必要的头文件，并按规则排序
确保头文件能独立编译，即包含它所需的其他头文件。包含顺序建议为：
示例：
#include "MyClass.h" #include#include #include "Utils.h"
5. 避免 using 指令污染全局命名空间
不要在头文件中使用 using namespace std; 这类语句，会将命名空间注入所有包含该头文件的文件，容易引发命名冲突。
正确做法： 在实现文件（.cpp）中使用，或在头文件中使用具体引入（不推荐）或限定作用域。
示例：
std::string getName(); // 推荐
6. 内联函数和模板的特殊处理
模板和内联函数的定义必须放在头文件中，因为编译器需要在每个使用点看到其完整实现。
示例：
templateT max(T a, T b) { return a > b ? a : b; }
这类内容可以定义在头文件中，但应保持简洁。
7. 注释与接口文档
为类、函数、常量添加清晰注释，说明用途、参数、返回值等。可配合Doxygen等工具生成文档。
示例：
/** * 计算两个数的和 * @param a 第一个数 * @param b 第二个数 * @return 和 */ int add(int a, int b);
基本上就这些。遵循这些规范，能写出清晰、安全、高效的C++头文件。
