C语言头文件相关编译报错：Undefined Reference Error 求助

问题背景 #

开发C语言链表项目时，使用VS Code作为编辑器，包含main.c、list.c、list.h三个文件，编译时出现链接错误，提示函数未定义。已确认文件路径正确，函数声明与定义匹配，但问题仍未解决。

项目文件内容 #

main.c #

#include "list.h"
#include <stdio.h>

int main()
{
    List* l = lst_create();
    l = lst_inset(l,10);
    l = lst_inset(l,20);
    l = lst_inset(l,25);
    l = lst_inset(l,30);
    //l = lst_rem(l,10); 
    lst_print(l);

    return 0;
}

list.c #

#include <stdio.h>
#include <stdlib.h>
#include "list.h"

struct list
{
    int info;
    List *next;
};

List* lst_create()
{
    return NULL;
}

int lst_empty(List *l)
{
    return (l == NULL);
}

List* lst_inset(List *l, int info)
{
    List* lAux = (List*) malloc(sizeof(List));

    lAux -> info = info;
    lAux -> next = l;

    return lAux;
}

List* lst_search(List *l, int info)
{
    List* lAux = l;

    while (lAux != NULL)
    {
        if (lAux -> info == info)
        {
            return lAux;
        }

        lAux = lAux -> next;
    }

    return NULL;
}

void lst_print(List *l)
{
    List* lAux = l;

    while (lAux != NULL)
    {
        printf("Info = %d\n", lAux -> info);
        lAux = lAux -> next;
    }
}

list.h #

#ifndef LIST_H
#define LIST_H

typedef struct list List;

List* lst_create();

int lst_empty(List *l);

List* lst_inset(List *l, int info);

//List* lst_remove(List *l, int info);

//void lst_free(List *l);

void lst_print(List *l);

List* lst_search(List *l, int info);

#endif

编译错误信息 #

/usr/bin/ld: /tmp/ccCzNKTb.o: in function 'main':
/home/user/Codes/C/TestProject/src/main.c:7: undefined reference to 'lst_create'
/home/user/Codes/C/TestProject/src/main.c:8: undefined reference to 'lst_insert'
/home/user/Codes/C/TestProject/src/main.c:9: undefined reference to 'lst_insert'
/home/user/Codes/C/TestProject/src/main.c:10: undefined reference to 'lst_insert'
/home/user/Codes/C/TestProject/src/main.c:11: undefined reference to 'lst_insert'
/home/user/Codes/C/TestProject/src/main.c:13: undefined reference to 'lst_print'
collect2: error: ld returned 1 exit status

解决步骤 #

1. 修正函数拼写错误 #

错误提示中出现的lst_insert与代码中定义的lst_inset（缺少字母'r'）不匹配。检查main.c中的函数调用，确保所有调用的函数名与list.c、list.h中的声明/定义完全一致，统一为lst_inset。

2. 完整编译所有源文件 #

链接错误的核心原因通常是仅编译了main.c，未将list.c纳入编译流程。在终端执行以下命令完成编译链接：

gcc main.c list.c -o linked_list_program

如果使用VS Code的编译任务，修改.vscode/tasks.json确保包含所有源文件：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build project",
            "type": "shell",
            "command": "gcc ${workspaceFolder}/main.c ${workspaceFolder}/list.c -o ${workspaceFolder}/program",
            "group": {"kind": "build", "isDefault": true},
            "problemMatcher": ["$gcc"]
        }
    ]
}

3. 验证头文件与源文件路径 #

若文件不在同一目录，编译时需通过-I参数指定头文件目录。例如：

gcc main.c ./src/list.c -I ./include -o program

4. 核对函数声明与定义一致性 #

确保list.h中的函数声明和list.c中的定义完全一致，包括返回值类型、参数类型及数量。例如lst_create、lst_print的声明和定义必须完全匹配，避免因隐式声明或类型不匹配导致的链接问题。

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