项目是多个源文件、头文件和构建配置的集合，而非单个.cpp文件；单文件程序无法解决多文件协作、符号复用与编译依赖管理等问题。
项目不是文件，而是多个源文件+头文件+构建配置的集合；单个源文件（如 main.cpp）只是项目中可编译的一个单元。
为什么不能只写一个 .cpp 文件就叫“项目”
当你在 Dev-C++ 或 VS Code 里新建一个 main.cpp 并运行成功，这只是“单文件程序”，不是项目。它没解决多文件协作、符号复用、编译依赖管理等问题。一旦你加第二个 utils.cpp，就必须让编译器知道：main.cpp 里调用的函数定义在哪儿、utils.cpp 用到的类声明从哪来——这正是项目结构要干的事。
常见错误现象：
- 直接
#include "utils.cpp"：编译可能过，但链接时报multiple definition of 'xxx'，因为两个编译单元都包含了同一份实现 - 删掉
utils.cpp后还能编译：说明它根本没被加入构建流程，IDE 没把它当编译目标
项目里常见的三类文件及其真实作用
项目 ≠ 一堆文件随便扔进文件夹。每个后缀承担明确角色，且影响编译行为：
-
.h或.hpp：纯声明容器。只放类定义、函数签名、extern变量、宏、constexpr常量。必须配头文件保护（#ifndef XXX_H），否则被多个.cpp包含时会触发重定义 -
.cpp（或.cc、.cxx）：唯一允许放函数/成员函数定义的地方。每个.cpp是独立编译单元，生成一个.o或.obj目标文件 - 项目配置文件（如
CMakeLists.txt、.devcpp、.vcxproj）：告诉构建工具“哪些.cpp要参与编译”“依赖哪些头文件路径”“是否启用 C++17”。没有它，IDE 就不知道该把哪几个文件喂给编译器
Dev-C++ 里“新建项目”和“新建源文件”的实际差异
在 Dev-C++ 中：
- 选“新建 → 源文件”：只建一个孤立的
.cpp，不自动加入任何构建上下文。即使你保存了，也不代表它会被编译进最终程序 - 选“新建 → 项目 → Console Application”：自动生成
main.cpp，并创建一个.devcpp工程文件。后续你右键项目名 → “New File”，新文件才会被 IDE 记录为项目成员，参与编译链接 - 漏掉这一步的典型表现：你写了
helper.cpp和helper.h，main.cpp也#include "helper.h"了，但一编译就报undefined reference to 'xxx'——因为helper.cpp根本没被编译
最容易被忽略的一点：头文件本身不参与编译，只有被 #include 进某个 .cpp 时，它的内容才进入那个编译单元。所以“项目里有 math.hpp”不等于“它生效了”，得看有没有 .cpp 文件真正包含并用到它。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
