企业官网建设流程全解析

cmake与makefile的区别

核心总结：
CMake是「构建文件生成器」，通过跨平台语法生成适配不同环境的Makefile（或其他构建文件）；Makefile是「编译规则文件」，直接定义编译依赖和命令，依赖Make工具执行，仅适配类Unix环境。

CMake 常用命令详解

本文整理了CMake构建过程中最常用的核心命令，涵盖版本设置、变量定义、项目配置、编译构建、安装部署等全流程，方便快速查阅和使用。

基础配置命令

1. 指定CMake最低版本

cmake_minimum_required(VERSION 3.1.3)

• 作用：限定构建当前项目所需的CMake最低版本，低于该版本会直接报错，确保语法和特性兼容。
• 示例：cmake_minimum_required(VERSION 3.20)（推荐使用项目兼容的较高稳定版本）

2. 设置项目名称

project(project_name) # 扩展：指定项目语言和版本 project(project_name LANGUAGES C CXX VERSION 1.0.0)

• 作用：定义项目名称，同时会自动生成PROJECT_NAME、PROJECT_VERSION等预定义变量。
• 参数说明：
  • LANGUAGES：指定项目支持的编程语言（如C、CXX/C++、Fortran等）；
  • VERSION：设置项目版本号。

变量操作命令

1. 普通变量定义与赋值

# 单值赋值 set(variable "content") # 多值赋值（列表形式） set(variable content1 content2 content3) # 设置C++标准（核心常用） set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 强制要求指定的C++标准，不兼容则报错

• 作用：定义自定义变量或修改CMake预定义变量，支持单值/多值（列表）赋值。
• 注意：CMAKE_CXX_STANDARD用于指定编译时的C++特性标准（如11/14/17/20），需配合CMAKE_CXX_STANDARD_REQUIRED确保生效。

2. 列表操作（添加元素）

# 初始化空列表 set(variable_name "") # 向列表追加元素 list(APPEND variable_name "content1") list(APPEND variable_name "content2" "content3")

• 作用：管理列表类型变量，常用于收集源码文件、头文件路径等。

3. 预定义核心变量

4. 字符串替换

string(REPLACE ".old" ".new" dest_variable "original_string.old")

• 作用：将源字符串中的指定子串替换为新子串，并将结果存入目标变量。
• 示例：执行后dest_variable的值为original_string.new。

编译构建命令

1. 添加头文件搜索路径

include_directories( ${CMAKE_CURRENT_SOURCE_DIR}/include ${CMAKE_CURRENT_SOURCE_DIR}/third_party/include )

• 作用：指定编译器查找头文件的目录，等价于GCC的-I参数。
• 推荐用法：现代CMake更推荐使用target_include_directories（针对具体目标），避免全局污染。

2. 查找目录下的所有源码文件

aux_source_directory(${CMAKE_CURRENT_SOURCE_DIR}/src src_files)

• 作用：递归查找指定目录下的所有源码文件（.c/.cpp），并将文件路径列表存入变量。
• 注意：若目录下文件结构复杂，建议手动列出源码文件，避免意外引入无关文件。

3. 添加可执行目标

add_executable(app_name ${src_files} main.cpp)

• 作用：指定编译生成的可执行文件名称，并关联对应的源码文件。
• 参数：app_name为可执行文件名称，后续为依赖的源码文件列表。

4. 链接库文件

target_link_libraries(app_name # 系统库/第三方库 pthread # 自定义库（需先通过add_library定义） ${CMAKE_CURRENT_SOURCE_DIR}/lib/libxxx.a my_custom_lib )

• 作用：为指定目标链接依赖的库文件，等价于GCC的-l参数。
• 分类：支持静态库（.a）、动态库（.so/.dll），优先链接系统库，再链接自定义库。

流程控制命令

1. 文件存在性判断

if (NOT EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/config.h) message(FATAL_ERROR "配置文件config.h不存在，请检查！") endif()

• 作用：判断文件/目录是否存在，配合if/endif实现条件逻辑。
• 扩展：支持EXISTS（存在）、NOT EXISTS（不存在）、IS_DIRECTORY（是否为目录）等判断条件。

2. 循环遍历

set(numbers 1 2 3 4 5) foreach(val IN LISTS numbers) message(STATUS "当前值：${val}") endforeach()

• 作用：遍历列表中的每个元素，执行循环体中的命令。
• 语法：foreach(变量 IN LISTS 列表变量)或foreach(变量 元素1 元素2)。

3. 打印日志/错误

# 普通状态提示（编译时输出，不中断） message(STATUS "当前编译目录：${CMAKE_CURRENT_BINARY_DIR}") # 警告提示（黄色输出，不中断） message(WARNING "未指定C++标准，默认使用C++11") # 致命错误（红色输出，中断编译） message(FATAL_ERROR "缺少核心依赖库，请安装后重试！")

• 作用：输出构建过程中的信息，辅助调试和错误排查。

高级操作命令

1. 执行自定义命令

add_custom_command( TARGET app_name # 关联到指定目标 PRE_BUILD # 执行时机：编译目标前（可选：PRE_LINK/POST_BUILD） COMMAND echo "开始编译app_name..." # 要执行的指令 ARGS -n "编译时间：$(date)" # 指令参数 DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/version.h # 依赖文件（文件更新则重新执行） COMMENT "执行预编译检查..." # 编译时打印的提示信息 )

• 执行时机可选值：
  • PRE_BUILD：目标编译前（仅Visual Studio支持）；
  • PRE_LINK：编译完成后、链接前；
  • POST_BUILD：链接完成后（最常用）。
• 作用：在构建流程的指定阶段执行自定义指令（如脚本、系统命令）。

2. 添加子目录（嵌套CMake）

add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/lib) add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/test EXCLUDE_FROM_ALL)

• 作用：指定子目录，CMake会递归处理该目录下的CMakeLists.txt。
• 参数：EXCLUDE_FROM_ALL表示子目录目标不加入默认构建（需手动指定构建）。

3. 设置安装路径

# 安装可执行文件到指定目录 INSTALL(TARGETS app_name RUNTIME DESTINATION ${CMAKE_INSTALL_PREFIX}/bin # 可执行文件安装路径 LIBRARY DESTINATION ${CMAKE_INSTALL_PREFIX}/lib # 动态库安装路径（Unix） ARCHIVE DESTINATION ${CMAKE_INSTALL_PREFIX}/lib # 静态库安装路径（Unix） ) # 安装头文件 INSTALL(FILES ${CMAKE_CURRENT_SOURCE_DIR}/include/app.h DESTINATION ${CMAKE_INSTALL_PREFIX}/include )

• 作用：指定目标文件/头文件的安装路径，执行make install时自动拷贝文件到对应目录。
• 常用参数：
  • RUNTIME：可执行文件（Windows下的.exe、Unix下的可执行程序）；
  • LIBRARY：共享库（.so/.dylib）；
  • ARCHIVE：静态库（.a）。

总结

以上命令覆盖了CMake从基础配置、变量操作、编译构建到安装部署的核心场景：

• 基础配置：cmake_minimum_required、project是每个CMakeLists.txt的必选开头；
• 现代CMake推荐：优先使用target_*系列命令（如target_include_directories、target_link_libraries）替代全局命令，降低耦合；
• 调试技巧：通过message(STATUS)打印变量值，排查路径、依赖等问题；
• 安装部署：INSTALL命令配合CMAKE_INSTALL_PREFIX实现跨平台的安装路径控制。