函数声明是编译器校验调用正确性的前提，必须放在调用前，采用完整原型（明确返回类型和各参数类型），多文件项目中统一收口至头文件，配合源文件定义实现接口一致性与模块化。
函数声明不是可有可无的“形式”，而是编译器校验调用正确性的前提。写得规范，能避免参数错传、类型不匹配、链接失败等隐蔽问题；写得随意，轻则警告频出，重则运行时崩溃。
声明必须放在调用之前
编译器自上而下扫描代码，遇到函数调用时，必须已知其接口信息。否则报“implicit declaration”或“undefined reference”错误。
- 若函数定义在 main() 之后，必须在 main() 前加完整原型声明，例如：int calculate(int a, int b);
- 若函数定义写在 main() 之前，可省略声明——但这仅适用于单文件小项目，工程中不推荐依赖此方式
- 多文件项目中，声明统一收口到头文件（.h），各源文件通过 #include "xxx.h" 引入，确保所有调用点看到一致接口
必须使用完整函数原型
所谓“完整”，是指明确写出返回类型、每个参数的类型（名称可省，但类型不可缺），且不能留空括号。
- ✅ 正确写法：double power(double base, int exp); 或简写为 double power(double, int);
- ❌ 错误写法：double power(); —— 这在C中表示“参数未指定”，不检查传参个数和类型；C++中虽视为无参，但语义模糊，应避免
- ❌ 更危险写法：int process(); 配合 process(1, "hello", &x); 调用——编译不报错，运行可能栈溢出或数据错乱
头文件中声明 + 源文件中定义是工程标配
这是模块化开发的基础结构，也是团队协作和大型项目的强制约定。
- 在 math_utils.h 中只写声明：float avg(float arr[], int len);
- 在 math_utils.c 中写定义，并 #include "math_utils.h" —— 这样编译器能比对声明与定义是否完全一致（如返回类型、参数类型），发现不匹配立即报错
- 所有使用该函数的其他 .c 文件，只需 #include "math_utils.h"，无需知道实现细节
- 切忌把定义直接写在头文件里（除非是 inline 或 static 内联函数），否则会导致多重定义链接错误
命名与格式保持可读性
声明是接口文档的第一行，要让别人（包括未来的你）一眼看懂它做什么、要什么、给什么。
- 参数名建议保留，哪怕只是示意用途：比如 void log_error(const char* msg, int line_num); 比 void log_error(const char*, int); 更易理解
- 返回值类型清晰表达意图：用 bool 表示成功/失败，用 size_t 表示长度或计数，避免滥用 int
- 一行一声明，参数对齐或按逻辑分组，避免挤在一行里难以维护
