Visual Studio 2022中C++项目添加子文件夹的正确方法及结构规范

你现在的问题不是头文件找不到，是对应的.cpp文件没被纳入项目编译——VS的过滤器只是逻辑分组，和实际文件是否参与编译完全无关。如果移动文件后没把.cpp文件添加到项目里，链接器找不到函数实现，自然报未定义的错误。

• 先在项目的磁盘目录里创建实际的子文件夹（比如src/、include/），把.h和.cpp文件分别移进去
• 在VS里右键项目 -> 添加 -> 现有项，选中子文件夹里的所有.h和.cpp文件，点击添加
• 要是想让VS视图里的分组和磁盘文件夹对应：右键项目 -> 添加 -> 过滤器，命名和磁盘子文件夹一致，再把添加进来的文件拖到对应的过滤器里（这步只是整理视图，不影响编译）
• 配置包含目录：右键项目 -> 属性 -> C/C++ -> 常规 -> 附加包含目录，添加子文件夹的路径（比如$(ProjectDir)include），确保头文件能被正确引用

小型项目可以按以下结构组织，清晰好维护：

你的项目名/
├─ 项目名.vcxproj
├─ include/          # 存放所有头文件(.h/.hpp)
│  ├─ module1/       # 按功能模块拆分的子目录（可选）
│  └─ module2/
├─ src/              # 存放所有源文件(.cpp/.cc)
│  ├─ module1/
│  └─ module2/
├─ resources/        # 存放图片、配置等资源文件（可选）
└─ tests/            # 测试代码目录（可选）

• 头文件和源文件按模块拆分，避免所有文件堆在一起
• 别在头文件里写普通函数实现（inline函数、模板除外），确保每个模块的头文件对应到源文件的实现
• 引用头文件时，要么用相对路径（比如#include "include/module1/xxx.h"），要么通过附加包含目录简化成#include "module1/xxx.h"

内容的提问来源于stack exchange，提问作者Elnur