现象
Ubuntu 22.04 上编译 llama.cpp,执行 cmake --build build -j8 到链接阶段失败,报 undefined reference to cblas_sgemm,前面所有源文件都编译通过了。重装 gcc、清理 build 目录再试,仍然是同一个符号找不到。
原因
这是链接期错误,说明编译时开启了 BLAS 支持,但链接器没有找到对应的库。常见原因是只装了 OpenBLAS 的运行包,缺 libopenblas-dev;或者 CMake 找到了另一个只提供头文件的环境,比如 conda 里的副本。CMake 3.28 调整了 findBLAS 的查找顺序,旧机器上同时存在多个 BLAS 实现时容易选错。
解决步骤
第一步,看缓存里到底选了哪个 BLAS。打开 CMakeCache.txt 搜索 BLAS 关键字,确认路径是不是系统库,而不是某个虚拟环境里的残缺副本。
grep -i blas build/CMakeCache.txt
sudo apt install -y libopenblas-dev
cmake -B build -DGGML_BLAS=OFF
cmake --build build -j8
第二步,先关掉 BLAS 验证链路。用 -DGGML_BLAS=OFF 重新配置并编译,如果能过,说明问题只在 BLAS 依赖,不在源码。此时可以先用纯 CPU 后端跑通推理,再回头补库。
第三步,需要 BLAS 时指定具体库。重新配置时加上 -DGGML_BLAS_VENDOR=OpenBLAS,或者用 CMAKE_PREFIX_PATH 指向 /usr,避免 conda 的 lib 目录抢先被找到。改完删除 build 目录重新生成,不要沿用旧缓存。
验证
编译结束没有 undefined reference,执行 ./build/bin/llama-CLI --version 能打印版本号,再加载一个小模型跑一次对话,输出正常即说明链接和运行时都没问题。
小结
undefined reference 要按链接期问题处理,先看 CMakeCache 的库路径,再用关闭 BLAS 的方式做对照。缓存不清理就反复改参数,往往只是重复踩同一个坑。
