函数声明必须出现在调用之前，否则编译报错；应通过头文件（带包含守卫）或前置声明确保可见性，定义只能在单一.cpp中实现。
函数声明必须出现在调用之前
编译器从上到下扫描源文件，遇到函数调用时，必须已经见过它的声明（或定义），否则报错 error: 'xxx' was not declared in this scope。这不是链接问题，是编译期的符号可见性问题。
常见错误场景：
- 在
main()后面定义函数，又没在前面加声明 - 头文件没被
#include，或#include顺序颠倒（比如先用了std::vector，再#include <vector></vector>） - 声明写在某个作用域内（如另一个函数里），外部无法访问
头文件是标准位置，但要注意包含守卫
把函数声明统一放进 .h 或 .hpp 文件，是 C++ 项目最常见也最安全的做法。但光放进去不够，得防重复包含。
正确写法示例（utils.h）：
#ifndef UTILS_H #define UTILS_H <p>int add(int a, int b); // 声明放这里 void log_message(const char* msg);</p><h1>endif</h1>
没加守卫会导致多次定义冲突；用 #pragma once 也行，但跨编译器兼容性略弱于 #ifndef。
同一源文件内可直接前置声明，但仅限简单情况
如果函数只在单个 .cpp 文件里用，且逻辑简单，可以不建头文件，就在文件顶部写声明：
int helper(int x); // 前置声明
<p>int main() {
return helper(42); // OK：声明在前
}</p><p>int helper(int x) { // 定义在后
return x * 2;
}</p>
注意限制：
- 不能用于模板函数（模板声明和定义通常需在一起）
- 不能用于依赖未完成类型的函数（如参数是
class Foo，但Foo还没定义） - 参数/返回类型必须完整（比如不能写
std::vector<t></t>而不#include <vector></vector>）
类成员函数声明必须在类定义内
类的接口和实现是分离的：声明（含 public/private 修饰）必须写在 class 大括号里；定义可以放外面。
错误写法：
class A {
int get_value(); // ✅ 声明在这里
};
int A::get_value() { return 42; } // ✅ 定义可以放后面或另个文件
<p>// ❌ 不能这样：在类外“重新声明”成员函数
int A::get_value(); // 编译器不认识这种语法</p>
另外，inline 成员函数如果定义在类内，就自动成为声明+定义一体；放在类外则必须带 A:: 作用域限定符。
最容易被忽略的是：头文件中声明的函数，其定义（实现）必须且只能在一个 .cpp 文件里提供，否则链接时报 multiple definition。声明可以无数次出现，定义只能一次——这个边界比看起来更关键。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
