WSL2 Ubuntu远程VS Code无法找到C++头文件，求解决方案

1. 修正编译命令的头文件路径参数 #

gcc的-I选项仅接受目录路径，不支持**通配符。修改tasks.json中的args部分，将-I${workspaceFolder}/sim/include/**改为-I${workspaceFolder}/sim/include：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "compile",
            "command": "g++",
            "args": [
                "-g",
                "${file}",
                "${workspaceFolder}/sim/include/add.cpp",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                "-I${workspaceFolder}/sim/include"
            ],
            "problemMatcher": {
                "owner": "cpp",
                "fileLocation": [
                    "relative",
                    "${workspaceRoot}"
                ],
                "pattern": {
                    "regexp": "^(.*):(\\d+):(\\d+):\\s+(warning|error):\\s+(.*)$",
                    "file": 1,
                    "line": 2,
                    "column": 3,
                    "severity": 4,
                    "message": 5
                }
            },
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

2. 修复文件名大小写不匹配 #

Linux系统严格区分文件名大小写，main.cpp中写的#include "Add.h"与实际文件add.h不匹配，二选一修改：

• 将代码中的包含语句改为#include "add.h"
• 或把sim/include/add.h重命名为Add.h

3. 移除头文件中错误的源文件包含 #

add.h中的#include "main.cpp"会导致编译时重复定义main函数，直接删除该行，修改后的add.h：

// Add.h
#include <iostream>
using namespace std;

int add(int a, int b);

4. 确保编译所有依赖源文件 #

当前编译命令仅处理main.cpp，未编译实现add函数的add.cpp，所以需要在tasks.json的args中加入add.cpp的路径（如步骤1中的配置所示）。如果后续文件增多，建议直接使用项目中的Makefile管理编译，示例sim/Makefile如下：

CC = g++
CFLAGS = -g -Wall -Iinclude
TARGET = main
SRCS = src/main.cpp include/add.cpp
OBJS = $(SRCS:.cpp=.o)

all: $(TARGET)

$(TARGET): $(OBJS)
	$(CC) $(CFLAGS) -o $@ $^

%.o: %.cpp
	$(CC) $(CFLAGS) -c -o $@ $<

clean:
	rm -f $(OBJS) $(TARGET)

同时修改tasks.json为调用make：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "compile",
            "command": "make",
            "args": [],
            "options": {
                "cwd": "${workspaceFolder}/sim"
            },
            "problemMatcher": {
                "owner": "cpp",
                "fileLocation": [
                    "relative",
                    "${workspaceRoot}/sim"
                ],
                "pattern": {
                    "regexp": "^(.*):(\\d+):(\\d+):\\s+(warning|error):\\s+(.*)$",
                    "file": 1,
                    "line": 2,
                    "column": 3,
                    "severity": 4,
                    "message": 5
                }
            },
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

并将launch.json中的program路径改为${workspaceFolder}/sim/main，确保调试的是Makefile生成的可执行文件。

最终验证 #

完成上述修改后，按下F5调试，应能正常编译并输出10 + 20 = 30。

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