1. 在 X86 的 Ubuntu 上把 CycloneDDS 编成可执行文件:先选对代码开发工具
拿到一份 C 语言版本的 CycloneDDS 源码,要在 X86 的 Ubuntu 上编出库和可执行文件,第一件要定的事是使用哪套代码开发工具,先不要急着找现成的二进制包。有人习惯 gcc *.c 一把直接编译,几十个源文件加依赖关系会把人劝退;也有人图省事直接把产物装到 /usr/local,等到要并存两份版本、要回滚、要对比 Debug 和 Release 行为时才发现位置已被占死。下面走的是 git + CMake + make 这条链:clone 源码、在源码包下另建 build 和 install_dds,用 -DCMAKE_INSTALL_PREFIX 把安装根目录固定在自己能控制的路径里。适合需要指定安装前缀、需要在同一台机器上并存多份编译产物、或者要给下游工程指路的人。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工具链盘点:gcc、make、cmake、git 各管哪一段
2.1 四件工具的分工,别在报错时才回头猜
先理清各工具职责,后面任何一条报错都能定位。git 只负责把源码取到本地,它不管编译;cmake 不编译任何一行 C 代码,它读源码根目录的 CMakeLists.txt,探测编译器、查找依赖、把探测结果写进缓存文件,最后生成 Makefile;make 读这份 Makefile,决定先编哪个 .c、后链哪个 .so;真正调用 gcc 执行编译和链接的,是 make 展开出来的那条命令行。很多人看到 make 报错就去翻源码,其实错误可能来自配置阶段没找到的头文件,只是被缓存带到了编译阶段才爆出来。
X86 平台这个前提要单独说一句:它意味着不需要交叉编译工具链,Ubuntu 系统自带的 gcc 目标就是 x86-64,编出来的产物在本机直接能跑。反过来,如果你是在 X86 机器上给 ARM 板子编,那就得挂 -DCMAKE_TOOLCHAIN_FILE 之类的交叉编译配置,路径和前缀的玩法完全不同,不要混着套。C 版本这个前提也有影响:源码以 C 文件为主,但配置阶段很多 CMake 工程会顺带探测 C++ 编译器,所以 g++ 也要装上,只装 gcc 有可能在配置阶段就被卡住。
工具链的边界也要提前知道:cmake 生成的 Makefile 是“中间产物”,不是你的源码,任何手工修改都会在下一次重新配置时被覆盖。想改编译选项,改的是传给 cmake 的参数,不是 Makefile 里的那几行。
2.2 开工前先用三条命令自检
bash复制# 1. 五个工具是否都在 PATH 里,有任何一个没输出就说明没装
which git cmake make gcc g++
# 2. CMake 版本,要和源码根目录 CMakeLists.txt 里 cmake_minimum_required 对一下
cmake --version
# 3. 编译器版本与默认目标架构,确认是 x86-64
gcc -v
第一条命令的输出是五个绝对路径,缺哪个补哪个。Ubuntu 上最省事的做法是装 build-essential,它带 gcc、g++、make 和基础头文件,再单独装 cmake 和 git:
bash复制sudo apt update
sudo apt install -y build-essential cmake git
第二条命令的意义常被忽略。源码根目录的 CMakeLists.txt 开头通常会写 cmake_minimum_required,本地 cmake 低于这个要求时,配置阶段第一条就报错退出,不会给你“先编着看”的机会。与其等到报错再去升级,不如先看一眼:
bash复制grep -n "cmake_minimum_required" ~/cyclonedds-master/CMakeLists.txt
第三条命令看的是 Target: x86_64-linux-gnu 这一行,确认自己没有被环境变量里残留的交叉编译器覆盖。如果之前在 shell 里 export 过 CC、CXX,cmake 配置时会优先用它们,产物的架构可能和你以为的不一样,这是后面 file 检查会暴露的问题之一。
2.3 目录先分三份:源码包、build、install_dds
bash复制cd ~
git clone <仓库地址> cyclonedds-master # 源码包,目录名保持 cyclonedds-master
cd cyclonedds-master
mkdir -p build install_dds # build 放过程文件,install_dds 放最终安装产物
这三份目录的划分是整套流程的基础。cyclonedds-master 是 clone 下来的源码包,除源码外不放任何生成物,这样 git status 永远是干净的,改坏了能随时 git checkout 回来。build 建在源码包下面,所有 CMake 生成的文件、目标文件、中间库都落在这里,好处是“推倒重来”只需要 rm -rf build 一条命令,源码一行不动。install_dds 是安装根目录,对应 CMake 里的 CMAKE_INSTALL_PREFIX,make install 之后头文件、库文件、可执行文件都在这棵树下。
为什么不用默认的 /usr/local?一是权限,写 /usr/local 通常要 sudo,一旦用 sudo 编译安装,产物属主变成 root,后面想删想改都别扭;二是隔离,装到自己的目录里,删掉整个 install_dds 就等于卸载干净,不留残渣;三是并存,同一台机器上编两版,各给一个前缀,互不打扰,下游工程用 CMAKE_PREFIX_PATH 指哪份就用哪份。这三点在只编一次的场景下感觉不到,编到第三次就会感谢当初分了目录。
3. CMake 配置:让 -DCMAKE_INSTALL_PREFIX 真正落到 install_dds
3.1 一条配置命令拆成四段看
bash复制cd ~/cyclonedds-master/build
# -D 定义/覆盖一个缓存变量;CMAKE_INSTALL_PREFIX 决定 make install 的根目录
# 最后那个 .. 是源码根目录,告诉 cmake 去哪里读 CMakeLists.txt
cmake -DCMAKE_INSTALL_PREFIX=$HOME/cyclonedds-master/install_dds ..
这条命令有四个部分。cmake 是程序本体。-D 是“定义缓存变量”的开关,后面跟 变量名=值,这里的 CMAKE_INSTALL_PREFIX 是 CMake 内置变量,默认值是 /usr/local,你给它什么值,make install 就装到哪。$HOME/cyclonedds-master/install_dds 是值,强烈建议写绝对路径:相对路径在某些情况下会被解释成相对当前构建目录,../install_dds 和 install_dds 差一层,装错位置后排查很费时间,写死绝对路径一劳永逸。最后的 .. 是源码目录,因为在 build 里执行,所以指向上一级,也就是源码包根目录。
还有几个可选参数值得知道怎么取舍。-DCMAKE_BUILD_TYPE=Release 会关掉大部分优化缺省值、去掉调试符号,产物体积小、运行快,但出问题时栈回溯信息少;不指定构建类型时通常带 -g,方便 gdb 跟进去看。做功能验证和性能对比用 Release,排查崩溃用 Debug,两者用不同的 build 目录分开编,不要在同一份缓存里反复改。-DCMAKE_VERBOSE_MAKEFILE=ON 会让编译时打印完整命令行,想确认某个文件到底用了哪些宏和包含路径时非常有用。
3.2 configuration done 与 generation done 分别代表什么
配置成功时终端末尾会出现两行标志:Configuring done 和 Generating done。前一行代表配置阶段走完:编译器探测、依赖查找、编译选项计算全部结束,结果写进缓存。后一行代表生成阶段走完:按缓存里的结论把 Makefile 和一批构建规则真正写出来。两行都出现,才算这一步过了。
如果只看到 Configuring done 而没有 Generating done,或者结尾是 Configuring incomplete, errors occurred!,说明配置阶段就失败了,此时不要往下 make,先翻上面第一条以 CMake Error 开头的内容。反过来,如果两行都有但中间夹了一堆 Could NOT find xxx,那是警告级问题:optional 依赖没找到,工程选择降级继续,缓存里会留下 xxx_DIR-NOTFOUND 之类的条目,后面链接时才炸,现象和原因隔了十万八千里。我的习惯是配置完成先扫一遍输出里的 NOTFOUND,有就先处理,不要留到编译阶段。
还有一类“看着成功其实埋雷”的情况:依赖找是找到了,但找到的是系统里另一份旧版本,头文件路径指到了 /usr/include 而不是你刚装的目录。判断方法是配置完成后去看缓存里那几个 *_DIR、*_INCLUDE_DIR 的实际值,别只看有没有报错。
3.3 build 目录里生成的东西,哪些能看哪些别碰
bash复制ls ~/cyclonedds-master/build
# 典型的几样:Makefile、CMakeCache.txt、CMakeFiles/、以及各子目录的构建规则
Makefile 是给 make 读的,别手改,改了下一次重新配置就没了,要改行为就改传给 cmake 的参数。CMakeFiles/ 里放的是编译器探测结果、测试程序、每个目标的依赖描述,是 cmake 的内部工作区,看不懂很正常,也不需要动。真正需要会读的是 CMakeCache.txt,它是这一整套流程里的后悔药,也是翻车源头:所有 -D 传进去的值都缓存在这里,第二次执行 cmake 时,没在命令行重新指定的变量会沿用缓存里的旧值,而不是回到默认值。
配置完成后立刻验一次前缀是否真的落地:
bash复制grep -n "CMAKE_INSTALL_PREFIX" ~/cyclonedds-master/build/CMakeCache.txt
# 期望看到:CMAKE_INSTALL_PREFIX:PATH=/home/<用户名>/cyclonedds-master/install_dds
输出的值如果还是 /usr/local,说明这次 -D 没生效,比如拼错了变量名、或者根本没在 build 目录下执行、或者上一条命令因为别的原因提前退出了。这一步花十秒钟,能省掉后面“装完找不到库”的半小时。
4. 从 Makefile 到可执行文件:make、make install 与前缀落地
4.1 make 的并行度、日志与第一条错误
bash复制cd ~/cyclonedds-master/build
# -j 后面跟并行任务数,$(nproc) 是本机 CPU 核数
# 2>&1 | tee build.log 把标准错误并进标准输出,同时打到屏幕和文件
make -j"$(nproc)" 2>&1 | tee build.log
-j 控制并行编译的任务数,等于 CPU 核数是个稳妥起点,再多不一定更快,反而在内存吃紧的机器上容易触发 OOM 把编译器杀掉,现象是莫名其妙的 internal compiler error 或者进程直接被 KILL。机器内存小的时候把并行度降到 -j4 甚至 -j2,编得慢一点但稳。
2>&1 | tee build.log 这段是血泪经验。编译失败时终端最后一屏往往只是“错误发生之后的连带输出”,真正的原因在几百行之前。把输出同时落到 build.log,失败后直接 grep -n "error:" build.log | head 拿到第一条错误的位置,从那里往回看五行上下文,九成情况下原因就在里面。不要从最后一条错误开始读,链接阶段的错误往往是前面编译告警累积出来的结果,末尾那条只是最显眼的一条。
编完之后确认退出码,别只看屏幕滚完了就当成功:
bash复制echo $? # 0 才算成功
4.2 make install 把东西放到了哪
bash复制cd ~/cyclonedds-master/build
make install
# 看安装根目录下生成了哪些子目录
find ~/cyclonedds-master/install_dds -maxdepth 2 -type d
make install 做的事就是把构建产物按 CMake 里的安装规则复制到 CMAKE_INSTALL_PREFIX 下面,常见的目录结构是 include/ 放头文件、lib/ 放库文件、bin/ 放可执行文件,CMake 工程通常还会在 lib/cmake/ 或 lib/pkgconfig/ 下留一份配置,供下游工程查找。安装过程本身没有编译动作,所以如果它报错,基本只有两类:权限不足,或者前面构建没完成导致某些目标文件不存在。
find -maxdepth 2 -type d 只列两层目录,够看清结构又不至于刷屏。想看得更细就针对具体子目录列:
bash复制ls ~/cyclonedds-master/install_dds/include
ls ~/cyclonedds-master/install_dds/lib
ls ~/cyclonedds-master/install_dds/bin
这一步值得认真看:include 下应该出现源码对外暴露的头文件,lib 下应该出现动态库或静态库,bin 下应该出现工具类可执行文件。如果 bin 是空的,先别怀疑安装,回去看 build 目录里对应目标有没有生成,很多时候是配置时某个开关没打开,压根没编这个目标。
4.3 三招验证产物:架构、依赖、运行
bash复制# 1. 确认产物架构是 x86-64,排除误用交叉编译器
file ~/cyclonedds-master/install_dds/bin/*
# 2. 列出装出来的库文件,动态库和静态库都在这里
find ~/cyclonedds-master/install_dds -name "*.so*" -o -name "*.a"
# 3. 查可执行文件依赖哪些动态库,看是否指到了 install_dds 里的那份
ldd ~/cyclonedds-master/install_dds/bin/<可执行名>
file 的输出应该是 ELF 64-bit LSB ... x86-64。如果出现 ARM aarch64,说明环境里残留了交叉编译器的配置,回去清掉 CC、CXX 和工具链文件,删掉 build 重新配置。
ldd 会列出每个依赖库解析到的绝对路径。如果它显示的是 /usr/lib/x86_64-linux-gnu/libxxx.so,而不是你刚装的 install_dds/lib 下那份,说明运行时搜索路径没覆盖到自己的目录。临时解决办法是设 LD_LIBRARY_PATH:
bash复制export LD_LIBRARY_PATH=$HOME/cyclonedds-master/install_dds/lib:$LD_LIBRARY_PATH
ldd ~/cyclonedds-master/install_dds/bin/<可执行名> | grep install_dds
LD_LIBRARY_PATH 只对当前 shell 生效,关掉就没了,适合调试阶段;长期使用要么写进自己的环境脚本,要么把库目录登记到系统动态库搜索路径里再刷新。这一步验证通过,才算真正拿到了“能跑”的产物,而不只是“装上”的产物。
5. 排查:五个把 X86 编译卡住的典型现象
5.1 源码树里多出 CMakeCache.txt,第二次配置怎么都不对
现象:在源码根目录直接敲过 cmake .,之后源码目录里多了一堆生成物,git status 一片红;再想换安装前缀重新配置,改什么都不生效。
原因:在源码目录里配置属于 in-source build,CMake 把缓存和生成文件写进了源码树,源码目录成了构建目录。之后再进 build 配置,工程里就存在两套互相不知道对方存在的缓存,判断“配置是否最新”的依据全乱了。
解决:清掉源码树里的生成物,回到 out-of-source 的用法。
bash复制cd ~/cyclonedds-master
rm -rf CMakeCache.txt CMakeFiles cmake_install.cmake Makefile
cd build
cmake -DCMAKE_INSTALL_PREFIX=$HOME/cyclonedds-master/install_dds ..
清理前先确认这些文件确实是 CMake 生成的,别把源码里的同名文件误删。
5.2 改了安装前缀,make install 还是装到 /usr/local
现象:命令行明明带了 -DCMAKE_INSTALL_PREFIX=.../install_dds,装完发现 install_dds 是空的,文件跑到 /usr/local/include、/usr/local/lib 下面去了。
原因:第一次配置时没带这个参数,缓存里已经存了默认值 /usr/local;后续再执行 cmake 时,如果这次命令行没重新指定,或者指定了但因为别的错误提前退出,缓存就沿用旧值。变量名拼错(比如少写一个 _)也会被当成新变量收下,旧的 CMAKE_INSTALL_PREFIX 原封不动。
解决:先查缓存里到底是什么值,再决定重配还是清缓存。
bash复制grep -n "CMAKE_INSTALL_PREFIX" build/CMakeCache.txt
# 值不对时,进 build 重新带参数配置
cd build
cmake -DCMAKE_INSTALL_PREFIX=$HOME/cyclonedds-master/install_dds ..
grep -n "CMAKE_INSTALL_PREFIX" CMakeCache.txt
缓存已经被搅乱、重配也刷不干净时,直接 rm -rf build 重建,比在那里反复试参数快得多。
5.3 make install 报 Permission denied
现象:make install 走到一半停下,提示某个目标目录 Permission denied,前面编译明明一路顺利。
原因:安装前缀指向了需要 root 权限的目录,比如 /usr/local 或者 /opt 下的路径。编译在工作目录里进行,普通用户完全够用;安装要写系统目录,权限就不够了。更麻烦的是,一旦用 sudo 跑完安装,后续想覆盖或删除这些文件还得继续 sudo。
解决:把前缀改回自己有写权限的目录,重新配置再安装。
bash复制cd ~/cyclonedds-master/build
cmake -DCMAKE_INSTALL_PREFIX=$HOME/cyclonedds-master/install_dds ..
make install
确实需要装到系统目录时,优先用 DESTDIR 做暂存安装再整体搬移,而不是养成随手 sudo 的习惯。
5.4 配置阶段报 Could NOT find,编译到链接才炸
现象:配置输出里一堆 Could NOT find xxx,但两行 done 照样出现,看着像成功;一路 make 到链接阶段才报一堆 undefined reference。
原因:这些依赖在工程里被标成了可选,找不到就用降级方案继续配置,但降级方案可能缺少某个符号;或者找不到的原因只是缺了开发包(运行库装了、头文件没装)。缓存里留下 NOTFOUND 之后,后面每次配置都不会重新去找,除非显式清掉。
解决:按报错里的名字补开发包,补完清缓存重配。
bash复制# 报错里出现的是 xxx 时,Ubuntu 上一般对应 libxxx-dev
sudo apt install -y libxxx-dev
cd ~/cyclonedds-master/build
rm -f CMakeCache.txt
cmake -DCMAKE_INSTALL_PREFIX=$HOME/cyclonedds-master/install_dds ..
重新配置后确认输出里那条 NOTFOUND 消失了,再往下编译。
5.5 CMake 版本不够,配置第一条就退出
现象:刚敲完 cmake 命令,一行 CMake Error at CMakeLists.txt:1 直接把流程终止,后面什么都没生成。
原因:本地 cmake 版本低于源码根目录声明的 cmake_minimum_required。这类错误发生在读文件的第一行,跟依赖、前缀、编译器都无关,属于工具链本身的门槛。
解决:先看要求是多少,再决定升级方式。
bash复制grep -n "cmake_minimum_required" ~/cyclonedds-master/CMakeLists.txt
cmake --version
系统仓库里的版本落后时,可以装一份更新的到自己的目录,或者用官方提供的独立安装包解压后临时加到 PATH 前面。不要为了跑起来去改源码里的最低版本声明,那等于绕过了工程作者的兼容性假设,后面编出来的东西出问题更难查。
6. 把前缀、缓存、复用固化成一套可重复的编译习惯
同一份源码编到第三遍,拼的就不再是编译知识,而是“上一次的参数我记不记得”。我现在的做法是把几个关键动作固定下来。配置完成后一定查缓存里的前缀,用的是 cmake -L -N . | grep INSTALL_PREFIX,只列变量不触发重新配置,比翻文件快;构建和安装统一用 cmake --build . -j"$(nproc)" 和 cmake --install .,这两个命令不依赖当前用的是 Makefile 还是别的生成器,换环境时脚本不用改。
bash复制cd ~/cyclonedds-master/build
# 只看缓存变量,不触发重新配置
cmake -L -N . | grep -i "INSTALL_PREFIX"
# 与 make 等价的写法,对生成器无感
cmake --build . -j"$(nproc)" 2>&1 | tee build.log
cmake --install .
下游工程要用这份产物时,别去改系统全局配置,指路就行:
bash复制# 在自己工程的 CMakeLists 里,或者作为命令行参数传入
cmake -DCMAKE_PREFIX_PATH=$HOME/cyclonedds-master/install_dds ..
# 同时装了两份不同版本时,用哪个前缀就链哪个
有一个细节值得写进脚本:前缀路径一律用绝对路径,并且在脚本开头检查 install_dds 目录是否本进程创建,是就先清空再装。曾经有一次在同一份前缀上连续装了 Debug 和 Release,头文件被后者覆盖、库文件两份混在 lib 下,ldd 看到的是新版本、nm 查符号又是旧的,查了大半天才发现是安装目录没清干净。从那以后我每次 make install 前都强制先看一眼前缀目录里的时间戳,和这次构建的产物对不上就先清再装。CMAKE_INSTALL_PREFIX 这一点,别嫌麻烦,出问题的时候它最省事。希望帮到你。
