Visual Studio C++项目迁移至Linux与CMake的问题求助

一、CMake是否支持自动识别新增文件/目录？ #

完全支持。通过CMake的file(GLOB_RECURSE)命令可递归收集指定目录下的所有源文件，配合根目录级别的头文件包含设置，新增的子目录和文件无需修改CMakeLists.txt就能被编译系统识别。

二、适配你项目结构的示例CMakeLists.txt #

以下是针对你给出的项目结构编写的完整配置文件，关键部分带注释说明：

# 最低CMake版本要求（建议选3.16+，支持更多现代特性）
cmake_minimum_required(VERSION 3.16)

# 项目名称和使用的编程语言
project(MyCppProject CXX)

# 设置C++标准（根据你的项目需求调整，比如11/14/17）
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# 递归收集src目录下所有.cpp文件（包括所有子目录中的文件）
# 新增.cpp文件或子目录时，重新运行cmake即可自动识别
file(GLOB_RECURSE PROJECT_SOURCES
    "${PROJECT_SOURCE_DIR}/src/*.cpp"
)

# 创建可执行文件目标
add_executable(${PROJECT_NAME} ${PROJECT_SOURCES})

# 指定头文件包含目录
# 这里指定根目录后，代码中可以直接用#include "includeFolder1/xxx.h"或#include <includeFolder1/xxx.h>
# 新增include下的子目录无需修改此配置
target_include_directories(${PROJECT_NAME}
    PRIVATE
        # 如果src目录下也有头文件，需要加上这一行
        "${PROJECT_SOURCE_DIR}/src"
        # 项目根目录下的include文件夹
        "${PROJECT_SOURCE_DIR}/include"
)

# 指定库文件所在目录
target_link_directories(${PROJECT_NAME}
    PRIVATE
        "${PROJECT_SOURCE_DIR}/libs"
)

# 链接所需库文件
# 注意：Windows的.lib是Windows平台专属格式，Linux下需要替换为静态库(.a)或动态库(.so)
# 这里填写库名时要去掉后缀，比如library1.lib对应Linux下的liblibrary1.a，写library1即可
target_link_libraries(${PROJECT_NAME}
    PRIVATE
        library1
        library2
)

三、关键配置说明 #

• 自动收集源文件：file(GLOB_RECURSE)会递归遍历指定目录，匹配所有符合后缀的文件。新增源文件或子目录后，只需在build目录下重新执行cmake ..，CMake就会自动更新文件列表，无需修改CMakeLists.txt。
• 头文件自动识别：target_include_directories指定include根目录后，代码中引用子目录下的头文件时，直接写相对根目录的路径即可，新增子目录无需修改配置。
• 库文件注意事项：你当前的libs目录下是Windows的.lib文件，Linux无法直接使用。需要将这些库重新编译为Linux兼容的静态库(.a)或动态库(.so)，否则会出现链接失败的问题。

四、编译步骤 #

1. 进入项目根目录下的build文件夹：cd build
2. 生成Makefile：cmake ..
3. 编译项目：make
4. 运行可执行文件：./MyCppProject（文件名和CMakeLists里的项目名称一致）

五、常见问题排查 #

• 头文件仍无法识别：检查代码中的#include路径是否正确，比如include/includeFolder1/test.h，代码中应该写#include "includeFolder1/test.h"而非#include "include/includeFolder1/test.h"。同时确认target_include_directories中是否正确指定了include目录。
• 链接失败：确认库文件已转换成Linux格式，且target_link_libraries中的库名正确（去掉后缀，Linux库名通常以lib开头，比如liblibrary1.a对应库名library1）。

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