如何解决VSCode+MinGW环境下collect2.exe: ld返回1退出状态错误

错误原因分析 #

undefined reference是链接器错误，说明编译器能找到manual_strcpy的函数声明（否则会报编译错误），但链接阶段找不到该函数的二进制实现——本质是你没把包含这个函数实现的源文件加入编译流程。

具体解决方案 #

1. 确认函数实现与声明的一致性 #

假设你的三个模块是main.c、str_utils.c（存manual_strcpy实现）、str_utils.h（存函数声明）：

• 确保str_utils.c里有完整的函数实现，示例：

// str_utils.c
#include "str_utils.h"
void manual_strcpy(char* dest, const char* src) {
    while (*src != '\0') {
        *dest++ = *src++;
    }
    *dest = '\0';
}

• 确保main.c正确引入头文件：#include "str_utils.h"
• 检查函数名、参数类型、返回值是否完全一致（C语言区分大小写，签名不匹配会被视为不同函数）

2. 修改tasks.json，编译所有关联源文件 #

VSCode默认的编译任务只会编译当前打开的单个文件（比如main.c），必须修改配置把所有相关源文件加入编译命令：

错误配置示例（仅编译单个文件）

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: gcc.exe 生成活动文件",
            "command": "C:\\MinGW\\bin\\gcc.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}", // 仅编译当前打开的文件
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe"
            ]
        }
    ]
}

正确配置方式

方式1：明确列出所有源文件

适合文件数量少、结构清晰的场景：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: gcc.exe 生成所有文件",
            "command": "C:\\MinGW\\bin\\gcc.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "main.c",
                "str_utils.c", // 加入存函数实现的源文件
                // 如有第三个模块，继续添加对应的.c文件
                "-o",
                "${fileDirname}\\my_program.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": ["$gcc"],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "编译器: C:\\MinGW\\bin\\gcc.exe"
        }
    ]
}

方式2：用通配符编译所有C文件

适合当前目录下所有C文件都需要编译的场景：

"args": [
    "-fdiagnostics-color=always",
    "-g",
    "*.c", // 匹配目录下所有.c文件
    "-o",
    "${fileDirname}\\my_program.exe"
],

3. 手动编译验证（排查配置问题） #

如果修改tasks.json后仍报错，可直接在VSCode终端（快捷键`Ctrl+``）执行编译命令，确认是否是配置问题：

gcc main.c str_utils.c -o my_program.exe

• 若这条命令能成功生成exe，说明是tasks.json配置有误；
• 若仍报错，重新检查函数名拼写、签名是否完全一致，或源文件是否存在于当前目录。

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