构建产物丢失找不到速查：输出目录、多配置路径与 install 前缀

更新时间：2026-10-24。FAQ 速查页，面向「make 明明跑完了、退出码是 0，产物却不知道在哪」的同学。这类问题严格说不是报错——构建系统没觉得自己失败，失败的是「你以为产物在 A 处、它其实在 B 处，或者根本就没生成」。病因收敛在六根轴上：打包/清理脚本把输出目录连带产物一起删了、Debug 与 Release 多套构建目录互相张冠李戴、DESTDIR 与 CMAKE_INSTALL_PREFIX 套娃把文件装进了意想不到的前缀、all 目标里压根不含 install 一步、CI 里产物生成了但 artifact 归档路径写错没传出去、以及多架构共用时产物被后跑的构建改名或覆盖。顺一遍基本必中。如果构建本身就失败了而不是产物丢了，转 make 退出码非零速查。

本文要回答的问题

• make 成功退出，产物目录为什么是空的？
• Debug 构建的产物跑到 Release 目录（或反过来）是怎么回事？
• make install 之后文件到底装到哪了？
• DESTDIR 和 CMAKE_INSTALL_PREFIX 谁叠在谁前面？
• CI 里本地构建有产物、流水线产物却丢了，查哪里？

一、报错原文与典型现象

这类问题没有统一报错，典型是部署/打包步骤先炸（路径以 /proj/demo 占位）：

# 形态一：打包脚本找不到二进制
cp: cannot stat '/proj/demo/build/bin/server':
No such file or directory

# 形态二：install 后目录空空
$ make install && ls /proj/demo/dist
（无输出）

# 形态三：CI 归档步骤报路径不存在
Archive artifacts
ERROR: No files found matching
pattern 'build/out/**/*.tar.gz'

读现象先回答三个问题：产物生成了没有（构建日志里有没有链接/拷贝这一步）、生成到哪了（find 全盘找产物名）、是不是生成后又被清了（构建日志后半段有没有 clean/distclean 步骤）。三个答案一拼，九成案子当场定位。

二、病因处置速查表

报错现象 / 场景	可能原因	快速验证	处置
make 成功、输出目录空	后续步骤（打包脚本自带 clean）把产物删了	日志尾部搜 clean / rm -rf	拆步骤，打包与清理分两次跑
产物在但不在预期目录	Debug/Release 多套构建目录张冠李戴	find /proj/demo -name 产物名 全盘找	统一构建目录约定，脚本里写绝对路径
install 后文件装进奇怪前缀	DESTDIR 与 PREFIX 叠加理解错	make install DESTDIR=/tmp/x 试装看落点	记住公式：最终路径 = DESTDIR + PREFIX
make 跑完没有任何安装动作	all 目标不含 install，没人调它	make -n install 看有没有动作	流水线显式加 make install 一步
CI 报 pattern 无匹配、本地产物在	artifact 归档路径写错或工作目录不同	CI 里加 pwd && ls -R 打印	归档路径对齐实际生成目录
前一次产物被后一次覆盖	多架构/多配置共用同一输出目录互相改名覆盖	看产物 mtime 与架构（file 命令）	每配置独立输出目录，产物名带配置后缀

三、排查决策图

下面这张图是标准排查路线，颜色按角色区分：红是报错入口与命中的根因，蓝是排查动作，绿是通过分支，橙是修复动作，紫是防复发沉淀。

读这张图抓第一分流：find 全盘搜产物名——搜得到就是「位置认知错位」（多配置目录、前缀叠加、归档路径），走右支对齐路径；搜不到再分「压根没生成」（install 步没跑）和「生成后被清」（脚本连环 clean），两支都汇到同一修复动作后统一验收。

四、逐条排查展开

「构建成功 + 目录为空」的头号嫌疑是脚本连环 clean。 很多打包脚本开头是 make clean && make && package，中间还有别的步骤顺手 rm -rf build/out。单看 make 是成功的，但产物在后续步骤里被扫掉了。验证极简单：构建日志尾部搜 clean、rm -rf、distclean。处置：把「构建」「打包」「清理」拆成三个显式步骤，清理只在最后或下次构建开头做；CI 里禁止脚本隐式连环。

多配置目录张冠李戴是 CMake 工程的家常便饭。 工程里同时有 build-debug/、build-release/，你在 build-release 里编完，打包脚本却去 build/bin（旧约定）捞文件；或者 CMake 生成器的输出位置因 CMAKE_RUNTIME_OUTPUT_DIRECTORY 只对部分 target 生效而一半在 bin/ 一半在 src/ 子目录。find /proj/demo -name server -type f 一下全现形。根治：全工程统一 CMAKE_RUNTIME_OUTPUT_DIRECTORY / CMAKE_ARCHIVE_OUTPUT_DIRECTORY，打包脚本里路径用变量而不是字面量，变量与构建脚本共享同一份定义。

DESTDIR 与 PREFIX 的叠加公式背下来能省半小时。 最终安装路径 = DESTDIR + CMAKE_INSTALL_PREFIX（或 Makefile 的 prefix）+ 相对路径。DESTDIR 是给打包用的「假根」——比如要打成 rpm/deb 包时 make install DESTDIR=/tmp/stage，文件装进 /tmp/stage/usr/local/bin/...；而 CMAKE_INSTALL_PREFIX=/opt/demo 是把前缀定死为 /opt/demo。两者同时用就是 /tmp/stage/opt/demo/...。很多「install 后找不到」的案子，文件其实安安稳稳躺在 stage 目录里。验证姿势：make install DESTDIR=/tmp/x 试装一遍，find /tmp/x 看落点。

all 不含 install 是「以为装了其实没装」的固定剧本。 CMake 里 install() 规则只属于 install 目标，make（即 all）跑完什么都不会装；必须显式 make install 或 cmake --install build。流水线上常见写法是本地手动装过一次就忘了 CI 脚本里没这步。同理，Makefile 工程里 all 默认目标只链到编译，install 目标存在但没人调。排查：make -n install 看有没有动作，没有就是根本没定义 install。

CI artifact 丢失八成是路径错位而不是没生成。 构建在 runner 的某个工作目录里完成，归档步骤的 pattern 相对的是另一个目录（或写死了本地开发机的目录结构）。排查套路：在归档步骤前加一行 pwd && find . -name '*.tar.gz' -o -name 'server' 打印真实落点，再修 pattern。另外注意压缩打包步骤失败（tar 报错）但被 || true 吞掉，artifact 自然是空的。

多配置共用输出目录会让产物被悄悄覆盖。 同一 build/bin/ 先被 ARM 交叉构建写了一版，宿主构建又写一版同名文件，最后部署的永远看运气。file 命令看产物架构一眼识破。处置与 目标文件损坏速查 的规范一致：每配置每架构独立输出目录，产物名带配置后缀（如 server-arm64-release）。

还有两类低频但折磨人的变形值得知道。 一是大小写敏感差异：macOS 默认文件系统大小写不敏感，本地 Build/ 与 build/ 是同一目录，代码上了 Linux CI 就裂成两个目录，产物落在没人看的那个里——团队约定一律小写目录名可免疫。二是 .gitignore 误伤：产物目录被 ignore 后，某些「先检出干净副本再打包」的流水线会发现产物不在副本里，本质仍是路径约定与工具行为没对齐。两者都属于「约定没入库」的账，和前面的多配置目录同源。

处置顺序上有个省时间的习惯：先别急着改任何东西，把「构建日志全文 + 全盘 find 结果 + 产物 mtime」三样证据抓齐再动手——这类问题的误诊成本远高于诊断成本，边猜边改往往会把现场破坏掉，最后只能全量重编从头再来。

五、规范做法与预防

• 输出目录约定入库：build/<config>-<arch>/ 一级定死，写进 README 与 CI 变量，脚本里禁字面路径。
• install 显式成步：流水线里「构建」「安装」「打包」三步分开，每步退出码独立检查。
• 打包先列后装：make install DESTDIR=... 后紧跟 find DESTDIR -type f 清单输出，装没装、装哪了一目了然。
• 产物存在性断言：CI 打包步骤开头 [ -f 约定路径/产物名 ] 断言，缺失立即失败并打印全盘 find 结果。
• 归档路径与生成同源：CI artifact pattern 引用与构建脚本同一个输出变量，不二次手抄。
• 禁止脚本连环 clean：清理只允许发生在构建开头或独立任务，构建成功之后到归档完成之间零删除。

这一篇在知识体系里的位置

本篇是 Make/CMake 排错速查簇的「产物去向」入口篇：产物找不到但其实是构建中途失败被吞掉退出码时看 make 退出码非零速查；产物在但格式不对（架构混了）看 目标文件损坏 file truncated 速查；构建目录路径本身配错导致从头就编不过看 make 路径找不到速查。「find 定性生成与否 → 位置错位对齐路径、未生成补步骤、被清拆步骤」这条主线对一切产物去向类问题通用。

一句话总结

make 成功但产物找不到，先 find 全盘搜产物名定性：搜得到就是位置认知错位——多配置构建目录张冠李戴、DESTDIR + CMAKE_INSTALL_PREFIX 前缀叠加理解错、CI 归档 pattern 与实际工作目录错位，对齐路径即解；搜不到再分「install 步压根没跑」（make -n install 验证）与「生成后被脚本连环 clean 扫掉」（日志尾部搜 rm/clean）。修复后统一输出目录约定、流水线三步显式拆分、产物存在性断言进 CI，这类问题基本绝迹。