面向对象的C++入门项目必须拆分为main.cpp、ClassName.h、ClassName.cpp三个文件，头文件需加保护宏，否则因重复包含导致redefinition错误；全写在main.cpp中会阻碍复用与扩展。
直接说结论：一个面向对象的 C++ 入门项目，至少要拆成 main.cpp、ClassName.h、ClassName.cpp 三个文件，且头文件必须加保护宏（#ifndef/#define/#endif 或 #pragma once）——否则编译会报 redefinition 错误。
为什么不能全写在 main.cpp 里？
初学时把类定义、实现、main 全塞进一个文件看似省事，但一旦加第二个类、或想复用某个类，就会立刻卡住。C++ 的编译模型要求：每个声明（比如类定义）在同一个翻译单元中只能出现一次，而多个 .cpp 文件各自独立编译，若头文件没防护，被多次 #include 就会触发重复定义错误，例如：error: redefinition of 'class Triangle'。
拆开后的好处是显性的：
- 修改
Triangle.cpp时，只重新编译它，main.cpp不用动也不用重编 - 别人想用你的
Triangle类，只需#include "Triangle.h"，不用管实现细节 - 调试时能清晰定位问题在接口（
.h）还是逻辑（.cpp）
头文件（.h）里只能放什么？
头文件是“契约”，不是“实现”。它只暴露调用者需要知道的部分：
立即学习“C++免费学习笔记（深入）”；
- 类声明（
class Triangle { ... };），含public/private区分 - 成员函数原型（如
double getArea() const;），不带函数体 - 构造函数声明（如
Triangle(double a, double b, double c);） - 必要时的
#include（如<cmath>），但避免引入非必需头文件（比如别在.h里#include <iostream>）
常见错误：在 .h 里写函数实现（哪怕是一行 return x + y;），这会让所有包含它的 .cpp 都生成一份该函数代码，链接时报 multiple definition。
源文件（.cpp）里怎么组织实现？
ClassName.cpp 是“履约”的地方，它必须：
- 第一行就
#include "ClassName.h"（双引号，表示本地头文件） - 用作用域解析符写成员函数实现，例如：
double Triangle::getArea() const { ... } - 静态成员变量（如
static int count;）必须在.cpp中定义并初始化（int Triangle::count = 0;），否则链接失败 - 如果用到标准库类型（如
std::string），在.cpp里补#include <string>，不要依赖.h间接提供
注意：不要在 .cpp 里重复写类声明——那是 .h 的职责。重复会导致编译器困惑，尤其涉及模板或内联时。
项目目录结构怎么起步才不乱？
入门阶段不必一上来就建 include/、src/、build/ 多层嵌套。最简可行结构就是平铺：
my-triangle-project/ ├── main.cpp ├── Triangle.h └── Triangle.cpp
等项目长到 3–4 个类时，再自然升格为：
my-triangle-project/ ├── include/ │ └── Triangle.h ├── src/ │ ├── Triangle.cpp │ └── main.cpp └── CMakeLists.txt
此时 main.cpp 里写 #include "Triangle.h"（注意引号路径），并在 CMakeLists.txt 中设置 include_directories(include)。过早分目录反而增加路径配置负担，新手容易卡在 fatal error: Triangle.h: No such file or directory 上。
真正容易被忽略的点是：头文件保护机制和 .cpp 中静态成员的定义位置。这两个地方出错，编译器报的错往往看起来八竿子打不着，但根源就在这两处。
