在Linux系统中开发多线程应用程序时，CMake作为常用的跨平台构建工具，能够简化编译流程，但针对多线程特性的配置需要遵循特定规则，否则容易出现编译报错或者运行时线程功能异常的问题。
基础配置：链接pthread线程库
Linux下的多线程功能依赖pthread库，使用CMake构建时，首先需要确保编译和链接阶段都能正确关联该库。最基础的方式是通过find_package查找Threads包，再将其链接到目标程序。
# CMakeLists.txt基础配置示例 cmake_minimum_required(VERSION 3.10) project(multi_thread_demo) # 查找线程包 find_package(Threads REQUIRED) # 添加可执行文件 add_executable(thread_app main.cpp) # 链接线程库到目标程序 target_link_libraries(thread_app PRIVATE Threads::Threads)
添加多线程编译选项
部分编译器需要显式开启多线程相关的编译支持，比如GCC编译器可以通过添加-pthread编译选项来启用线程特性，避免编译时出现未定义引用的错误。
# 为所有目标添加编译选项的方式 add_compile_options(-pthread) # 或者仅为指定目标添加编译选项 target_compile_options(thread_app PRIVATE -pthread)
处理不同编译环境的差异
如果项目需要在不同编译器或者不同Linux发行版下构建，可以通过条件判断来适配不同的配置，避免硬编码导致的兼容性问题。
# 判断编译器类型添加对应选项
if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
target_compile_options(thread_app PRIVATE -pthread)
elseif(CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
target_compile_options(thread_app PRIVATE -pthread)
endif()
完整的多线程示例代码
以下是一个简单的多线程程序示例，配合前面的CMake配置可以完成完整构建。
#include <iostream>
#include <pthread.h>
#include <unistd.h>
// 线程执行函数
void* thread_func(void* arg) {
int thread_id = *(int*)arg;
for (int i = 0; i < 3; i++) {
std::cout << "线程" << thread_id << "正在运行，第" << i + 1 << "次循环" << std::endl;
sleep(1);
}
return nullptr;
}
int main() {
pthread_t t1, t2;
int id1 = 1, id2 = 2;
// 创建两个线程
pthread_create(&t1, nullptr, thread_func, &id1);
pthread_create(&t2, nullptr, thread_func, &id2);
// 等待线程结束
pthread_join(t1, nullptr);
pthread_join(t2, nullptr);
std::cout << "所有线程执行完毕" << std::endl;
return 0;
}
常见配置问题排查
- 如果出现
undefined reference to pthread_create错误，通常是没有正确链接pthread库，检查target_link_libraries配置是否正确 - 如果编译时提示线程相关头文件找不到，确认系统是否安装了pthread开发库，Debian系系统可以通过
sudo apt install libc6-dev安装 - 如果程序运行时线程无法正常创建，检查是否添加了
-pthread编译选项，该选项会同时影响编译和链接阶段的行为