已在头文件声明的函数出现未定义引用错误求助

1. 链接顺序错误（核心原因） #

GCC的链接规则是：被依赖的库要放在引用它的源文件/目标文件之后。你的Makefile编译posl目标时，把库-lposl放在了main.c前面，导致链接器无法找到init_poslState的定义。

2. 静态库打包了不必要的头文件 #

生成libposl.a时，你将./include/posl.h也加入了归档，但静态库只需要包含目标文件（.o），头文件无需打包进去。

3. 结构体typedef与函数实现的潜在问题（非直接错误，但建议修正） #

当前typedef struct POSL_STATE { ... } pState;的写法中，pState是结构体类型而非指针类型，且init_poslState返回栈上的局部变量，会触发未定义行为，建议调整为指针式设计。

修正步骤 #

步骤1：调整Makefile的链接顺序

修改posl目标的编译命令，将源文件放在库的前面：

posl: $(CLI_O_FILES) libposl.a ./src/CLI/main.c
    $(CC) -o posl ./src/CLI/main.c $(CLI_O_FILES) -L./ -lposl

步骤2：修正静态库生成规则

去掉头文件，仅打包目标文件：

libposl.a: $(O_FILES)
    ar rcs libposl.a $(O_FILES)

步骤3：修复结构体typedef与函数实现（可选但重要）

修改posl.h中的类型定义，将pState设为指针别名：

// State
typedef struct POSL_STATE {
    // ... 结构体成员
} POSL_State;
typedef POSL_State* pState;

pState init_poslState();
void free_poslState(pState poslState);

更新state.c的实现，使用堆内存分配避免未定义行为：

#include "state.h"
#include <posl.h>
#include <stdlib.h>

pState init_poslState() {
    pState newState = malloc(sizeof(POSL_State));
    if (newState == NULL) {
        return NULL;
    }
    // 初始化结构体成员
    return newState;
}

void free_poslState(pState poslState) {
    if (poslState != NULL) {
        free(poslState);
    }
}

步骤4：验证编译

执行make clean && make all，链接错误即可解决。

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