Mac系统VSC编译带关联头文件的C++多文件代码出现链接错误如何解决

错误根因 #

你遇到的链接报错是因为VSCode默认的C++编译逻辑仅处理当前打开的单个源文件，编译main.cpp时没有将library.cpp的实现一同编译参与链接，而CLion中CMake的add_executable配置已经明确包含了所有项目源文件，自动完成了多文件联合编译流程。

解决方案 #

方案1：修改默认编译任务（适合小型多文件项目） #

无需额外插件，直接修改VSCode的编译任务配置即可：

1. 按下Command + Shift + P唤起命令面板，选择Tasks: Configure Default Build Task，再选择C/C++: clang++ 生成活动文件，此时会自动生成.vscode/tasks.json文件
2. 修改tasks.json中的args参数，将默认的单文件编译规则替换为编译当前目录下所有cpp文件，修改后的配置参考：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: clang++ 生成活动文件",
            "command": "/usr/bin/clang++",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${fileDirname}/*.cpp", // 替换原来的${file}，编译当前目录所有cpp
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "调试器生成的任务。"
        }
    ]
}

3. 保存配置后按下Command + Shift + B即可完成多文件联合编译，直接运行生成的可执行文件即可。

方案2：使用CMake工具（和CLion逻辑一致，适合中大型项目） #

和你此前在CLion的使用习惯完全兼容：

1. 在VSCode扩展商店安装CMake和CMake Tools两个官方插件
2. 在项目根目录新建CMakeLists.txt，内容如下：

cmake_minimum_required(VERSION 3.15)
project(MyProject)

set(CMAKE_CXX_STANDARD 17)
# 所有项目源文件都列在这里，和CLion的配置逻辑一致
add_executable(MyProject main.cpp library.cpp library.h)

3. 点击VSCode左下角的编译套件选择按钮，选择Mac自带的clang编译器，之后直接点击下方工具栏的运行按钮即可自动完成编译、链接、运行全流程，后续新增文件只要更新add_executable里的文件列表即可。

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