VS2022中CMake项目新增头文件被识别为杂项文件的原因

问题根源 #

1. 当前CMake配置仅将src/*.cc源文件添加到pslite目标中。原有头文件能被识别，是因为它们被已加入目标的源文件引用，而新增头文件尚未关联到任何已知源文件，因此VS将其标记为杂项。
2. 你尝试添加src/test.h时出现了拼写错误：target_sources(psquic ...)中的目标名是psquic，但你的库目标实际是pslite，导致头文件未正确关联到目标。
3. CMake的GLOB_RECURSE不会自动检测新文件——新增文件后需要重新运行CMake配置，VS才能识别它们。

解决方案 #

方案1：使用现代CMake的FILE_SET（推荐，CMake 3.20+）

这种方式清晰区分公共/私有头文件，IDE能正确识别并归类：

add_library(pslite)

# 收集源文件、私有头文件（src目录下）、公共头文件（include目录下）
file(GLOB_RECURSE SOURCES "src/*.cc")
file(GLOB_RECURSE PRIVATE_HDRS "src/*.h")
file(GLOB_RECURSE PUBLIC_HDRS "include/*.h")

# 将源文件和私有头文件添加到目标
target_sources(pslite PRIVATE ${SOURCES} ${PRIVATE_HDRS})

# 注册公共头文件，让IDE正确识别
target_sources(pslite
  PUBLIC
    FILE_SET HEADERS
    BASE_DIRS "${PROJECT_SOURCE_DIR}/include"
    FILES ${PUBLIC_HDRS}
)

# 设置包含目录
target_include_directories(pslite
  PUBLIC "${PROJECT_SOURCE_DIR}/include"
  PRIVATE "${PROJECT_SOURCE_DIR}/src" # 若src目录有私有头文件，需添加此路径
)

方案2：兼容旧版CMake的显式添加方式

如果使用CMake 3.20以下版本，可直接将所有头文件加入target_sources：

add_library(pslite)

file(GLOB_RECURSE SOURCES "src/*.cc")
file(GLOB_RECURSE ALL_HDRS "src/*.h" "include/*.h")

target_sources(pslite PRIVATE ${SOURCES} ${ALL_HDRS})
target_include_directories(pslite PUBLIC "${PROJECT_SOURCE_DIR}/include")

关键注意事项 #

• 修改CMakeLists.txt或新增文件后，在VS2022中右键点击CMakeLists.txt，选择配置以更新项目，强制CMake重新扫描文件。
• 避免完全依赖GLOB_RECURSE：若新增/删除文件，CMake不会自动感知，必须重新配置。对重要项目，建议显式列出所有文件（虽然繁琐但更可靠）。
• 确保CMake命令中的目标名一致（始终使用pslite，不要拼写错误）。

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