cmake_file(GLOB)详解

本文介绍cmake的file()文件操作函数，该函数功能强大，可以读文件，写文件，复制，删除，重命名等操作。

第二章 CMake基础语法

2.9 file()

file() 是 CMake 中功能最强大的命令之一，用于执行各种文件系统操作（读写、搜索、复制等）。

2.9.1 file子命令

使用file(GLOB|GLOB RECURSE )命令匹配文件列表；
子命令：

GLOB I GLOB_RECURSE ： 生成与匹配的文件列表。GLOB 不搜索子目录；GLOB_RECURSE 会递归搜索子目录； WRITE 写入内容到文件中 MAKE DIRECTORY 创建给定的目录及其父目录。 REMOVE 删除给定的文件 COPY_FILE 复制文件 RELATIVE_PATH 计算相对路径。

2.9.2 GLOB/GLOB_RECURSE子命令的使用

使用GLOB/GLOB_RECURSE 来代替aux_source_directory 搜索目录下的文件。aux_source_directory只是搜索指定目录下的源文件；而FILE(GLOB)可以通过通配符搜索目录下的所有文件。
GLOB: 搜索当前目录符合模式的文件。
GLOB_RECURSE: 递归搜索子目录。
语法格式如下：

file(GLOB<variable>[LIST_DIRECTORIEStrue|false][RELATIVE<path>][CONFIGURE_DEPENDS]<globbing-expressions>...)

参数说明：

参数1：: 存储搜索结果的变量名。
参数2：[LIST_DIRECTORIES true|false]:是否在结果列表中包含目录。默认为 true。如果只想获取文件，可以设置为 false。
参数3：[RELATIVE]: 让返回的文件路径相对于指定的，而不是绝对路径。${CMAKE_CURRENT_SOURCE_DIR} 作为相对基准。
参数4：[CONFIGURE_DEPENDS] (重要：CMake 3.12+):解决 GLOB 不会自动更新的问题。
如果加上这个参数，CMake 会在构建时检查目录内容。如果增加了新文件，构建系统会自动重新运行 CMake 来更新文件列表。
示例：

file(GLOB SOURCES CONFIGURE_DEPENDS"*.cpp")

[FOLLOW_SYMLINKS] (仅限 GLOB_RECURSE):
是否递归进入符号链接指向的目录。
参数5：:匹配模式，可以写多个。
.cpp：匹配所有 C++ 源文件。
src/.h：匹配 src 目录下所有头文件。
test?.cpp：匹配 test1.cpp, test2.cpp 等（? 匹配单个字符）。
代码文件结构：

cmake_minimum_required(VERSION3.30)project(testfile VERSION1.0LANGUAGES CXX)# GLOBfile(GLOB SOURCES"*.cpp")message("SOURCES =${SOURCES}")# SOURCES = E:/cmakeLearning/chap2/5file/main.cpp;# E:/cmakeLearning/chap2/5file/mycul.cpp# 可以看出，搜索到了两个.cpp文件。# GLOB_RECURSE# file(GLOB_RECURSE ALL_SOURCES RELATIVE "./build" "*.cpp")file(GLOB_RECURSE ALL_SOURCES RELATIVE${CMAKE_CURRENT_SOURCE_DIR}CONFIGURE_DEPENDS"*.cpp")message("ALL_SOURCES =${ALL_SOURCES}")#[[ALL_SOURCES=a/a.cpp;build/CMakeFiles/4.2.1/CompilerIdCXX/CMakeCXXCompilerId.cpp;main.cpp;mycul.cpp]]# 可以发现，递归搜索出了目录下面的所有.cpp文件add_executable(testfile${SOURCES})

2.9.3 写文件 (WRITE / APPEND)

WRITE: 写入内容（覆盖原文件）。
APPEND: 在末尾追加内容。

message("###############################")file(WRITE"version.txt""hello cmake")#追加file(APPEND"version.txt""\nhello APPEND")

WRITE测试结果：会在当前目录下面生成一个version.txt文件，并在该文件中插入 hello cmake字符串。
APPEND测试结果：会在version.txt文件中，添加 hello APPEND字符串，结果如下：

2.9.4读文件 (READ / STRINGS)

READ: 读取整个文件内容。
STRINGS: 按行读取，适合处理配置文件。
下面分别测试

# 读文件file(READ"version.txt"CONTENTS)message("CONTENTS =${CONTENTS}")#[[CONTENTS=hello cmake hello APPEND]]# 按行读file(STRINGS"version.txt"lines)message("line =${lines}")# line = hello cmake;hello APPEND

2.9.5 复制/重命名/删除(COPY/RENAME/REMOVE)

拷贝测试：拷贝一份version.txt 到指定的目录下。

# 拷贝一份file(COPY"version.txt"DESTINATION"${CMAKE_CURRENT_SOURCE_DIR}/a/version.txt")

重命名测试：

# 重命名：将 a/version.txt 重命名为 a/version2.txtfile(RENAME"${CMAKE_CURRENT_SOURCE_DIR}/a/version.txt""${CMAKE_CURRENT_SOURCE_DIR}/a/version2.txt")

输出文件测试：删除指定的文件

# 删除文件或目录file(REMOVE"${CMAKE_CURRENT_SOURCE_DIR}/a/version2.txt")

2.9.6 file部分完整测试代码

cmake_minimum_required(VERSION3.30)project(testfile VERSION1.0LANGUAGES CXX)# GLOBfile(GLOB SOURCES"*.cpp")message("SOURCES =${SOURCES}")# SOURCES = E:/cmakeLearning/chap2/5file/main.cpp;# E:/cmakeLearning/chap2/5file/mycul.cpp# 可以看出，搜索到了两个.cpp文件。# GLOB_RECURSE# file(GLOB_RECURSE ALL_SOURCES RELATIVE "./build" "*.cpp")file(GLOB_RECURSE ALL_SOURCES RELATIVE${CMAKE_CURRENT_SOURCE_DIR}CONFIGURE_DEPENDS"*.cpp")message("ALL_SOURCES =${ALL_SOURCES}")#[[ALL_SOURCES=a/a.cpp;build/CMakeFiles/4.2.1/CompilerIdCXX/CMakeCXXCompilerId.cpp;main.cpp;mycul.cpp]]# 可以发现，递归搜索出了目录下面的所有.cpp文件message("###############################")file(WRITE"version.txt""hello cmake")#追加file(APPEND"version.txt""\nhello APPEND")# 读文件file(READ"version.txt"CONTENTS)message("CONTENTS =${CONTENTS}")#[[CONTENTS=hello cmake hello APPEND]]# 按行读file(STRINGS"version.txt"lines)message("line =${lines}")# line = hello cmake;hello APPEND# 拷贝一份#file(COPY "version.txt" DESTINATION "${CMAKE_CURRENT_SOURCE_DIR}/a/version.txt")# 重命名：将 a/version.txt 重命名为 a/version2.txt# file(RENAME "${CMAKE_CURRENT_SOURCE_DIR}/a/version.txt" "${CMAKE_CURRENT_SOURCE_DIR}/a/version2.txt")# 删除文件或目录file(REMOVE"${CMAKE_CURRENT_SOURCE_DIR}/a/version2.txt")add_executable(testfile${SOURCES})