个人主页艾莉丝努力练剑❄专栏传送门《C语言》《数据结构与算法》《C/C干货分享学习过程记录》《Linux操作系统编程详解》《笔试/面试常见算法从基础到进阶》《Python干货分享》⭐️为天地立心为生民立命为往圣继绝学为万世开太平 艾莉丝的简介文章目录1 ~ ChatServer项目CMake构建实战1.1 项目背景与构建前置要求1.2 CMakeLists.txt编写、错误修正与完整可用代码1.2.1 原始素材中存在的典型错误1.2.2 修正完成完整CMakeLists.txt1.3 CMake关键指令原理梳理1.3.1 link_directories1.3.2 target_link_libraries 链接库规则1.3.3 构建类型 CMAKE_BUILD_TYPE1.3.4 target_compile_definitions1.4 完整编译流程外部构建 out‑of‑source build1.4.1 创建构建目录并进入1.4.2 执行CMake配置1.4.3 执行编译链接1.5 高频踩坑问题与排错方案1.5.1 链接报错找不到自定义静态库1.5.2 编译通过链接阶段报符号未定义1.5.3 头文件找不到1.6 Release发布版本编译1.7 补充CMake概念拓展面试要点结尾1 ~ ChatServer项目CMake构建实战1.1 项目背景与构建前置要求项目AIChatServerC聊天服务器项目依赖自研SDK静态库与第三方开源库编译前置条件已经完成main.cpp、ChatServer.cpp业务源码开发自研SDK静态库libai_chat_sdk.a已经编译安装至/usr/local/lib系统预先部署依赖库OpenSSL、jsoncpp、fmt、spdlog、gflags、sqlite3CMake最低版本要求3.10C标准采用C17工程目录规范采用外部构建(out‑of‑source build)创建独立build编译目录避免编译产物污染源码目录1.2 CMakeLists.txt编写、错误修正与完整可用代码1.2.1 原始素材中存在的典型错误变量名拼写错误CHAKE_*系列正确前缀为CMAKE_target_link_libraries错误填写静态库全名libai_chat_sdk‑l链接器参数不需要前缀lib与后缀.a重复添加链接库gflags依赖库OpenSSL现代CMake规范使用导入目标OpenSSL::SSL、OpenSSL::Cryptolink_directories作用指定静态库搜索路径必须写在add_executable之前对后续target生效EXECUTABLE_OUTPUT_PATH旧变量现代CMake推荐使用CMAKE_RUNTIME_OUTPUT_DIRECTORY1.2.2 修正完成完整CMakeLists.txt# 指定CMake最低版本 cmake_minimum_required(VERSION 3.10) # 定义项目名称 project(AIChatServer) # 设置C编译标准 C17 set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 设置默认构建类型调试使用Debug发布版本编译改为Release set(CMAKE_BUILD_TYPE Debug) # 设置静态库搜索路径必须放置在add_executable之前 link_directories(/usr/local/lib) # 生成可执行程序指定项目源码文件 add_executable(AIChatServer main.cpp ChatServer.cpp ) # 设置可执行文件输出目录输出至build目录下 set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}) # 查找系统OpenSSL依赖库 find_package(OpenSSL REQUIRED) # 添加编译宏定义启用cpp‑httplib的OpenSSL HTTPS支持 target_compile_definitions(AIChatServer PRIVATE CPPHTTPLIB_OPENSSL_SUPPORT) # 链接所有依赖库 # 自研静态库ai_chat_sdk不要写lib前缀不要写.a后缀 target_link_libraries(AIChatServer ai_chat_sdk # 自研SDK静态库 libai_chat_sdk.a jsoncpp fmt spdlog gflags OpenSSL::SSL OpenSSL::Crypto sqlite3 )1.3 CMake关键指令原理梳理1.3.1 link_directories功能告诉链接器去哪里搜索静态/动态库文件语法link_directories(目录路径)重要注意事项该指令作用域为后续所有target必须放在add_executable / add_library前面写在后面不会生效现代CMake优先使用find_package导入目标link_directories多用于本地自定义静态库示例link_directories(/usr/local/lib)用于读取安装到此路径下自研静态库1.3.2 target_link_libraries 链接库规则Linux下静态库命名规范libxxx.a、动态库libxxx.soCMake填写规则只写中间库名xxxCMake自动补全lib前缀传递‑lxxx给gcc链接器错误案例静态库文件libai_chat_sdk.a写libai_chat_sdk→ 传递参数‑llibai_chat_sdk链接器查找liblibai_chat_sdk.a文件不存在直接报错报错信息识别cannot find -llibai_chat_sdk: No such file or directory就是库名多写lib前缀导致1.3.3 构建类型 CMAKE_BUILD_TYPEDebug调试模式开启调试符号‑g不做代码优化开发调试阶段使用Release发布模式开启代码优化去除调试符号正式上线发布编译使用修改方式修改CMakeLists内CMAKE_BUILD_TYPE变量或者cmake命令行传入参数‑DCMAKE_BUILD_TYPERelease1.3.4 target_compile_definitions作用为指定编译目标添加预编译宏示例CPPHTTPLIB_OPENSSL_SUPPORT开启http‑lib库的SSL HTTPS能力没有该宏会无法启用HTTPS1.4 完整编译流程外部构建 out‑of‑source build1.4.1 创建构建目录并进入# 在ChatServer源码目录下创建build文件夹mkdir-pbuildcdbuild1.4.2 执行CMake配置# cmake .. 代表读取上一级目录的CMakeLists.txt生成Makefile构建脚本cmake..成功输出标志Configuring done、Generating done生成Makefile与CMake缓存文件失败场景依赖库缺失OpenSSL未安装等find_package会直接报错终止配置1.4.3 执行编译链接make编译阶段把.cpp源码编译为.o目标文件链接阶段把目标文件 所有指定静态/动态库合并生成最终可执行文件AIChatServer成功标志[100%] Built target AIChatServer可执行文件生成在build目录1.5 高频踩坑问题与排错方案1.5.1 链接报错找不到自定义静态库报错cannot find -lxxx: No such file or directory排查步骤确认静态库真实存在ls /usr/local/lib/libai_chat_sdk.a确认库文件已经部署确认link_directories(/usr/local/lib)写在add_executable之前target_link_libraries库名不要写lib前缀不要写.a后缀如果特殊情况强制指定完整库文件‑l:libai_chat_sdk.a1.5.2 编译通过链接阶段报符号未定义现象编译cpp源文件正常链接报类、函数未定义例如日志器、ChatSDK相关符号找不到根因没有链接自研SDK静态库或者静态库编译ABI不匹配Debug/Release模式不一致C标准不一致解决方案确认target_link_libraries加入自研库确认SDK库编译C标准、构建类型和当前项目完全一致1.5.3 头文件找不到解决方案使用include_directories()或者target_include_directories()添加头文件搜索路径# 推荐现代写法仅对AIChatServer目标生效 target_include_directories(AIChatServer PRIVATE ${CMAKE_CURRENT_SOURCE_DIR} ${CMAKE_CURRENT_SOURCE_DIR}/../sdk/include )1.6 Release发布版本编译两种方式切换Release模式修改CMakeLists.txtset(CMAKE_BUILD_TYPE Release)重新执行cmake … make命令行传入参数不修改文件cdbuild cmake-DCMAKE_BUILD_TYPERelease..make1.7 补充CMake概念拓展面试要点外部构建(out‑of‑source)编译产物全部放到build源码目录保持干净是工业界标准做法禁止在源码目录直接执行cmakePRIVATE/PUBLIC/INTERFACEPRIVATE仅当前编译目标生效不会传递给依赖它的其他targetPUBLIC当前目标 依赖本目标的其他target都会生效INTERFACE仅依赖本目标的target生效自身不生效find_package(OpenSSL REQUIRED)REQUIRED代表找不到库直接终止CMake配置不会静默失败link_directories的缺点全局生效现代CMake优先使用导入目标例如OpenSSL::SSL导入目标自带库路径、头文件路径不需要手动配置link_directories结尾uu们本文的内容到这里就全部结束了艾莉丝在这里再次感谢您的阅读艾莉丝努力练剑C/C Linux 底层探索者 | 一个正在努力练剑的技术博主【关注】跟随我一起深耕技术领域见证每一次成长。❤️【点赞】让优质内容被更多人看见让知识传递更有力量。⭐【收藏】把核心知识点存好在需要时随时查、随时用。【评论】分享你的经验或疑问评论区一起交流避坑不要忘记给博主“一键四连”哦“今日练剑达成”“技术之路难免有困惑但同行的人会让前进更有方向。”结语希望对学习Linux相关内容的uu有所帮助不要忘记给博主“一键四连”哦往期回顾【AI大模型接入SDK】Trae生成main方法博主在这里放了一只小狗大家看完了摸摸小狗放松一下吧૮₍ ˶ ˊ ᴥ ˋ˶₎ა
