C语言共享库编译链接错误求助：未定义引用及库查找失败

问题背景 #

开发自定义C共享库vlibc时，编译测试程序遇到两个连续错误：

1. 初始错误：链接时提示undefined reference to "my_strlen"
2. 修改链接参数后：提示can't find -lvlibc，但vlibc.so确实存在于指定目录

初始错误信息 #

gcc -Wall -Wextra -Werror -g3 -I../includes -L../build -lc main.o -o test
/usr/bin/ld: main.o: in function `main':
main.c:(.text+0x27): undefined reference to `my_strlen'
collect2: error: ld returned 1 exit status
make: *** [Makefile:12: test] Error 1

更新后错误信息 #

将测试程序Makefile中的LFLAGS = -L../build -lc改为LFLAGS = -L../build -lvlibc后：

gcc -Wall -Wextra -Werror -g3 -I../includes -L../build -lvlibc main.o -o test
/usr/bin/ld: cannot find -lvlibc: No such file or directory
collect2: error: ld returned 1 exit status
make: *** [Makefile:12: test] Error 1

项目结构 #

.
├── build
│   └── vlibc.so
├── includes
│   └── vlibc.h
├── Makefile
├── src
│   ├── memory
│   │   ├── memdump.c
│   │   ├── memdump.o
│   │   ├── my_free.c
│   │   ├── my_free.o
│   │   ├── my_memcmp.c
│   │   ├── my_memcmp.o
│   │   ├── my_memcpy.c
│   │   ├── my_memcpy.o
│   │   ├── my_memove.c
│   │   ├── my_memove.o
│   │   ├── my_memset.c
│   │   └── my_memset.o
│   └── string
│       ├── my_strlen.c
│       └── my_strlen.o
└── tests
    ├── main.c
    ├── main.o
    └── Makefile

解决方案 #

1. 修正共享库命名（核心原因） #

Linux链接器处理-l<name>参数时，默认查找lib<name>.so格式的文件。当前库名为vlibc.so，而-lvlibc会寻找libvlibc.so，命名不匹配导致找不到库。

修改根目录Makefile：
将LIB_NAME = vlibc.so改为：

LIB_NAME = libvlibc.so

重新编译共享库：

make -C .. re

2. 调整链接参数顺序 #

GCC链接器处理参数的顺序很重要：目标文件必须放在链接库参数之前，否则链接器会先处理库，无法匹配后续目标文件的未定义引用。

修改tests/Makefile中的$(EXE_NAME)规则：
原规则：

$(EXE_NAME): $(OBJ)
    $(CC) $(CFLAGS) $(INC) $(LFLAGS) $^ -o $@

修改为：

$(EXE_NAME): $(OBJ)
    $(CC) $(CFLAGS) $(INC) $^ $(LFLAGS) -o $@

同时确保LFLAGS指向正确的库：

LFLAGS = -L../build -lvlibc

3. 验证共享库符号（可选） #

确认共享库中已导出my_strlen符号：

nm -D ../build/libvlibc.so | grep my_strlen

如果输出类似0000000000001120 T my_strlen，说明符号已正确导出。

4. 运行测试程序 #

编译测试程序后，若运行时提示找不到共享库，可临时指定库路径：

LD_LIBRARY_PATH=../build ./test

或者将../build目录添加到系统库路径（如修改/etc/ld.so.conf并执行ldconfig）。

补充说明 #

• 初始的undefined reference错误是因为错误链接了标准C库（-lc）而非自定义的vlibc库，导致找不到自定义函数。
• 遵循Linux共享库命名规范（lib<name>.so）可以避免大部分链接路径问题。

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