C++引用自定义静态库编译报错：/usr/bin/ld: cannot find -ltest

我正在编写C++程序，希望通过引入自定义静态库简化编译流程，无需手动添加多个源文件。项目结构如下：

apps/
    - /test
    - /test2

我在test2的Makefile中配置了引入test库：

STATIC_LIBS     += test
CFLAGS          += -I$(SWIFT_ROOT)/apps/test/
LDFLAGS         += -L$(SWIFT_ROOT)/apps/test

但编译时出现链接错误：

/usr/bin/ld: cannot find -ltest
collect2: error: ld returned 1 exit status

完整Makefile内容：

ENABLE_VERSION_API=1

TARGET = test2

SRCS += \
        main.cpp \
        test2.cpp \
        \
        # Add more

LIBS            +=
STATIC_LIBS     += test
EXT_STATIC_LIBS += ssl crypto ssh2 curl protobuf
EXT_LIBS        += z

CFLAGS    += -I$(SWIFT_ROOT)/include/google/protobuf/
CFLAGS    += -I$(SWIFT_ROOT)/libs/src/test2/
CFLAGS    += -I$(SWIFT_ROOT)/apps/test/
LDFLAGS   += -L$(SWIFT_ROOT)/apps/test
include $(SWIFT_ROOT)/build/app.mak

实际执行的编译命令：

g++ -I/root/include/google/protobuf/ -I/root/libs/src/test2/  -std=c++17 -Wno-unused-but-set-variable -Wno-misleading-indentation -Wno-deprecated-declarations -Wno-parentheses -Wno-switch -Wno-literal-suffix -Wno-conversion-null -Wno-format-contains-nul  -D_THREAD_SAFE -D_GNU_SOURCE -D__USE_GNU .builtobjs/main.o .builtobjs/test2.o -L/root/apps/test -Xlinker --start-group -lz -ldl -lpthread -lrt -luuid -lstdc++fs -Wl,-Bstatic -lssl -lcrypto -lssh2 -lcurl -lprotobuf -ltest -Wl,-Bdynamic -Xlinker --end-group -Wl,-rpath,/opt/swift/lib64 -Wl,-rpath,/opt/swift/lib -o test2

核心问题：已遵循添加库、CFLAGS(-I)和LDFLAGS(-L)的常规步骤，但仍链接失败，需排查改进方向。

排查与改进步骤 #

1. 确认静态库文件的存在性与命名 #

链接器-ltest会自动查找名为libtest.a（静态库）或libtest.so（动态库）的文件。执行以下命令检查目标路径下是否存在该文件：

ls $(SWIFT_ROOT)/apps/test/libtest.a

• 如果文件不存在：先编译test模块生成静态库，确保test目录的Makefile能正确输出libtest.a到指定路径。
• 如果库文件名不是libtest.a，需同步修改STATIC_LIBS的内容（例如库名为libmytest.a，则写STATIC_LIBS += mytest）。

2. 验证库文件的路径正确性 #

确认$(SWIFT_ROOT)/apps/test是静态库的实际存放路径：

• 在Makefile中添加$(info SWIFT_ROOT is $(SWIFT_ROOT))，查看输出的路径是否与实际库文件路径一致。
• 如果库文件存放在test目录的子文件夹（如build/），需更新LDFLAGS为-L$(SWIFT_ROOT)/apps/test/build。

3. 检查链接阶段的库顺序 #

C++链接器对库的顺序敏感，依赖库必须放在被依赖的对象或库之后。如果test库依赖其他已链接的库（如protobuf），需确保-ltest在依赖库之后出现（当前命令中-lprotobuf -ltest的顺序是正确的，但若test依赖其他未列出的库，需调整顺序）。

4. 检查app.mak的库处理逻辑 #

引入的$(SWIFT_ROOT)/build/app.mak可能对STATIC_LIBS有特殊处理规则：

• 查看app.mak是否会自动给库名添加前缀/后缀，或要求库文件存放在特定目录。
• 确认app.mak是否将STATIC_LIBS正确转换为链接参数（例如是否自动添加-l前缀）。

5. 直接指定库文件路径（绕过查找逻辑） #

如果以上步骤无效，可以直接在链接阶段指定库文件的绝对路径，替代-L和-l的组合：

# 替换原有的 STATIC_LIBS += test
LDFLAGS += $(SWIFT_ROOT)/apps/test/libtest.a

这种方式让链接器直接使用指定的库文件，避免路径查找问题。

内容的提问来源于stack exchange，提问作者Sumit Patil