C语言编译报错及VSCode配置疑问：终端启动失败与未定义引用

问题概述 #

• 编译包含fonction_lire.h、fonction_lire.c和test.c的项目时，出现undefined reference to 'lireDouble'链接错误
• 编译未生成test.exe，点击“Debug Anyway”提示launch: program mypath\test.exe does not exist
• 终端进程启动失败（exit code: -1）
• 疑问：文件夹中工作时，是否需要为每个项目单独创建包含launch.json和task.json的.vscode文件夹？如何创建？

相关文件代码 #

fonction_lire.c

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include "fonction_lire.h"
// 注：此处省略lireDouble等函数的实现代码

fonction_lire.h

#ifndef H_FILE
#define H_FILE

void viderBuffer();
int lire(char* chaine,int longueur);
long lireLong();
double lireDouble();

#endif

test.c

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

int main(int argc, char *argv[])
{
    double poid = 0;

    printf("Combien pesez vous ? ");
    poid = lireDouble();
    printf("Ah ! Vous pesez donc %f kg !\n\n", poid);

    return 0;
}

编译任务执行信息 #

Executing task: C/C++: gcc.exe build active file
Starting build...
C:\msys64\mingw64\bin\gcc.exe -fdiagnostics-color=always -g "C:\Users\Matt7\OneDrive - student.helmo.be\Bureau\MyCApp\fonction_lire\test.c" -o "C:\Users\Matt7\OneDrive - student.helmo.be\Bureau\MyCApp\fonction_lire\test.exe"
C:/msys64/mingw64/bin/../lib/gcc/x86_64-w64-mingw32/13.1.0/../../../../x86_64-w64-mingw32/bin/ld.exe: C:\Users\Matt7\AppData\Local\Temp\ccXChbyj.o: in function `main': C:/Users/Matt7/OneDrive - student.helmo.be/Bureau/MyCApp/fonction_lire/test.c:10: undefined reference to `lireDouble'
collect2.exe: error: ld returned 1 exit status
Build finished with error(s).
- The terminal process failed to launch (exit code: -1).
- Terminal will be reused by tasks, press any key to close it.

错误原因与解决方案 #

1. 链接错误：undefined reference to 'lireDouble' #

原因：当前编译命令只编译了test.c，没有把实现lireDouble函数的fonction_lire.c包含进来，导致链接阶段找不到函数的二进制实现。

解决方案：

• 手动编译时，执行包含所有.c文件的命令：

  gcc -g test.c fonction_lire.c -o test.exe
  

• 用VSCode任务编译时，修改task.json的编译参数，把fonction_lire.c加入编译列表。

2. 终端启动失败与exe不存在问题 #

原因：编译失败导致未生成test.exe，Debug时找不到可执行文件，终端进程无法正常启动。

解决方案：先解决上述链接错误，确保编译成功生成test.exe，终端和Debug功能即可正常工作。

关于VSCode的.vscode文件夹配置 #

是否需要每个项目单独创建？ #

是的。每个C项目建议单独创建.vscode文件夹存放配置文件，因为不同项目的编译参数、Debug配置可能存在差异，独立配置可避免冲突，保证每个项目的编译和Debug环境独立运行。

如何创建.vscode文件夹和配置文件？ #

1. 在项目根目录（存放test.c、fonction_lire.c的文件夹）中新建名为.vscode的文件夹。
2. 创建task.json（编译任务配置）：
   • 按Ctrl+Shift+B，选择“创建tasks.json文件”，选择“C/C++: gcc.exe build active file”模板，修改编译命令为包含所有.c文件：

     {
         "version": "2.0.0",
         "tasks": [
             {
                 "type": "cppbuild",
                 "label": "C/C++: gcc.exe build project",
                 "command": "C:\\msys64\\mingw64\\bin\\gcc.exe",
                 "args": [
                     "-fdiagnostics-color=always",
                     "-g",
                     "${fileDirname}\\test.c",
                     "${fileDirname}\\fonction_lire.c",
                     "-o",
                     "${fileDirname}\\test.exe"
                 ],
                 "options": {
                     "cwd": "${fileDirname}"
                 },
                 "problemMatcher": [
                     "$gcc"
                 ],
                 "group": {
                     "kind": "build",
                     "isDefault": true
                 },
                 "detail": "编译器: C:\\msys64\\mingw64\\bin\\gcc.exe"
             }
         ]
     }
     

3. 创建launch.json（Debug配置）：
   • 点击左侧Debug图标，选择“创建launch.json文件”，选择“C++ (GDB/LLDB)”模板，修改配置：

     {
         "version": "0.2.0",
         "configurations": [
             {
                 "name": "gcc.exe - 生成和调试活动文件",
                 "type": "cppdbg",
                 "request": "launch",
                 "program": "${fileDirname}\\test.exe",
                 "args": [],
                 "stopAtEntry": false,
                 "cwd": "${fileDirname}",
                 "environment": [],
                 "externalConsole": false,
                 "MIMode": "gdb",
                 "miDebuggerPath": "C:\\msys64\\mingw64\\bin\\gdb.exe",
                 "setupCommands": [
                     {
                         "description": "为 gdb 启用整齐打印",
                         "text": "-enable-pretty-printing",
                         "ignoreFailures": true
                     },
                     {
                         "description": "将反汇编风格设置为 Intel",
                         "text": "-gdb-set disassembly-flavor intel",
                         "ignoreFailures": true
                     }
                 ],
                 "preLaunchTask": "C/C++: gcc.exe build project"
             }
         ]
     }
     

   • 注意preLaunchTask的值要和task.json中的label一致，确保Debug前自动执行编译任务。

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