函数未定义错误排查：疑似Makefile配置问题

问题背景 #

编译代码时无法调用外部库的3个函数，提示函数未定义，怀疑是Makefile配置出错。

现有代码文件 #

Makefile #

CC      = gcc
CFLAGS  = -c -O2 -Wall
LDFLAGS =

all: zoom

zoom: lib_ppm.o zoom.o
  $(CC) $(LDFLAGS) lib_ppm.o zoom.o -o zoom

lib_ppm.o: lib_ppm.c
  $(CC) $(CFLAGS) -c lib_ppm.c

zoom.o: zoom.c
  $(CC) $(CFLAGS) -c zoom.c


clean:
  -rm -f *.o *~ zoom lena_copy.ppm test.ppm

lib_ppm.o: lib_ppm.h

主函数（zoom.c） #

#include <stdio.h>
#include <string.h>
#include "lib_ppm.h"

int main() {
/... 逻辑代码 .../
entry = read_ppm("lena.ppm", image_in);
if(entry < 0)
{
    printf("read_ppm error");
    return 0;
}  
/... 逻辑代码 .../
entry = new_ppm(image_out, data.width*3, data.height*3);
if( entry < 0)
{
    printf("new_ppm error");
    return 0;
}  
/... 逻辑代码 .../

entry = write_ppm("copy.ppm", image_out);
if( entry < 0)
{
    printf("read_ppm error");
    return 0;
}
}

头文件（lib_ppm.h） #

struct pixel_s {
    unsigned char r, g, b;
};

struct image_s {
    int width;
    int height;
    struct pixel_s *pix;
};

int read_ppm(char *file, struct image_s *image);
int write_ppm(char *file, struct image_s *image);
int new_ppm(struct image_s *image, int width, int height);
int free_ppm(struct image_s *image);

编译输出与报错信息 #

编译输出 #

make
gcc -c -O2 -Wall -c zoom.c
gcc  lib_ppm.o zoom.o -o zoom

报错信息 #

/usr/bin/ld: /tmp/ccoHFVnw.o: in function `main':
/workspaces/softwarebasico/zoom.c:13: undefined reference to `read_ppm'
/usr/bin/ld: /workspaces/softwarebasico/zoom.c:20: undefined reference to `new_ppm'
/usr/bin/ld: /workspaces/softwarebasico/zoom.c:48: undefined reference to `write_ppm'
collect2: error: ld returned 1 exit status

问题分析与解决方法 #

核心问题 #

1. 重复编译参数：编译输出里出现了两次-c——CFLAGS里已经包含-c，编译规则里又额外加了-c，导致编译逻辑异常。
2. 无效的依赖声明：单独写的lib_ppm.o: lib_ppm.h规则冗余且无效，正确做法是把头文件依赖合并到对应的编译规则中。
3. 依赖关联缺失：当前Makefile没有确保lib_ppm.o被正确编译，链接时可能用的是旧的、未包含函数实现的目标文件。

修正后的Makefile #

CC      = gcc
CFLAGS  = -O2 -Wall  # 移除重复的-c，编译阶段单独指定
LDFLAGS =

all: zoom

# 链接目标，自动引用所有依赖文件
zoom: lib_ppm.o zoom.o
	$(CC) $(LDFLAGS) $^ -o $@

# 编译lib_ppm.o，关联头文件依赖
lib_ppm.o: lib_ppm.c lib_ppm.h
	$(CC) $(CFLAGS) -c $< -o $@

# 编译zoom.o，关联头文件依赖
zoom.o: zoom.c lib_ppm.h
	$(CC) $(CFLAGS) -c $< -o $@

clean:
	-rm -f *.o *~ zoom lena_copy.ppm test.ppm

关键修改说明 #

• 移除CFLAGS中的-c，避免编译时重复添加该参数。
• 将头文件依赖合并到对应的.o编译规则中，确保头文件修改时自动重新编译相关源文件。
• 使用$^（所有依赖文件）和$<（第一个依赖文件）简化Makefile，减少手写错误。
• 确保lib_ppm.o的编译规则包含源文件和头文件，保证函数实现被正确编译到目标文件。

验证步骤 #

1. 执行make clean清理旧编译产物。
2. 执行make重新编译，正常流程应为：

   gcc -O2 -Wall -c lib_ppm.c -o lib_ppm.o
   gcc -O2 -Wall -c zoom.c -o zoom.o
   gcc  lib_ppm.o zoom.o -o zoom
   

3. 运行生成的zoom程序，确认函数调用正常。

内容的提问来源于stack exchange，提问作者Enzo R.C.