VSCode中使用C语言头文件遇问题：链接错误及头文件查找失败

一、链接错误：undefined reference to 'print1to10' #

问题原因 #

编译时仅单独编译了main.c，未将实现函数的print.c纳入编译流程，导致链接器无法找到函数的具体定义。

解决方法 #

方法1：终端直接编译

在项目根目录的终端中执行完整编译命令，将所有.c源文件包含进去：

gcc main.c print.c -o main.exe

执行完成后，运行./main.exe即可输出结果。

方法2：配置tasks.json实现一键编译

按Ctrl+Shift+B唤起编译任务面板，选择创建tasks.json文件，选择gcc编译模板后，修改配置为包含所有源文件的版本：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: gcc.exe 生成活动文件",
            "command": "C:/msys64/mingw64/bin/gcc.exe",
            "args": [
                "-g",
                "${workspaceFolder}/main.c",
                "${workspaceFolder}/print.c",
                "-o",
                "${workspaceFolder}/main.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": ["$gcc"],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: C:/msys64/mingw64/bin/gcc.exe"
        }
    ]
}

之后按Ctrl+Shift+B即可一键完成所有文件的编译。

二、子文件夹下头文件找不到问题 #

假设将print.c和print.h放入项目根目录的src子文件夹中，需做以下两处调整：

1. 修改main.c的头文件引用 #

将原有的头文件引用语句修改为：

#include "src/print.h"

2. 调整编译配置 #

终端编译方式

执行编译命令时，需指定子文件夹的源文件，并通过-I参数声明头文件目录：

gcc main.c src/print.c -I src -o main.exe

tasks.json配置方式

修改tasks.json的args部分，加入子文件夹的源文件路径和头文件目录参数：

"args": [
    "-g",
    "${workspaceFolder}/main.c",
    "${workspaceFolder}/src/print.c",
    "-I", "${workspaceFolder}/src",
    "-o",
    "${workspaceFolder}/main.exe"
]

注：你的c_cpp_properties.json中includePath已配置${workspaceFolder}/**，这能让VSCode的IntelliSense识别到头文件（不会显示红色波浪线），但编译时仍需通过上述方式告知编译器头文件和源文件的位置。

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