Mac系统VSCode中编译器找不到SFML/Graphics.hpp的问题求助

在Mac系统的VSCode中给C++项目配置SFML图形库，已经在tasks.json和c_cpp_properties.json里配置了头文件路径，但编译main.cpp或执行make命令时，出现以下错误：

main.cpp:5:10: fatal error: 'SFML/Graphics.hpp' file not found
#include <SFML/Graphics.hpp>
         ^~~~~~~~~~~~~~~~~~~
1 error generated.

现有配置与代码内容 #

tasks.json #

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "process",
            "label": "C/C++: clang build active file",
            "command": "/usr/bin/clang",
            "args": [
                "-fcolor-diagnostics",
                "-fansi-escape-codes",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                "-Iopt/homebrew/Cellar/boost/1.82.0_1/include",
                "-Iopt/homebrew/Cellar/sfml/2.6.0/include",
                "-I${workspaceFolder}",
                "-I${workspaceFolder}/include/boost"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build",
            "detail": "compiler: /usr/bin/clang"
        }
    ]
}

c_cpp_properties.json #

{
    "configurations": [
        {
            "name": "Mac",
            "includePath": [
                "${default}",
                "${workspaceFolder}",
                "/opt/homebrew/Cellar/boost/1.82.0_1/include",
                "/opt/homebrew/Cellar/sfml/2.6.0/include"
            ],
            "defines": [],
            "macFrameworkPath": [
                "/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks"
            ],
            "compilerPath": "/usr/bin/clang",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "macos-clang-arm64"
        }
    ],
    "version": 4
}

main.cpp #

#include <iostream>
#include <string>

using namespace std;
#include <SFML/Graphics.hpp>

int main(){
    cout << "Hello world" << endl;

    return 0;
}

解决方法 #

1. 修正头文件路径的语法错误 #

tasks.json里的-I参数后路径缺少开头的/，绝对路径必须以/开头，否则编译器会当作相对路径查找，自然找不到文件。把：

"-Iopt/homebrew/Cellar/boost/1.82.0_1/include",
"-Iopt/homebrew/Cellar/sfml/2.6.0/include",

改为：

"-I/opt/homebrew/Cellar/boost/1.82.0_1/include",
"-I/opt/homebrew/Cellar/sfml/2.6.0/include",

2. 改用clang++编译C++程序 #

当前使用的clang是C语言编译器，编译C++程序应该用clang++，否则可能出现编译逻辑错误。把tasks.json里的command改为：

"command": "/usr/bin/clang++",

3. 添加SFML库的链接参数 #

即使头文件路径正确，编译时还需要链接SFML的库文件，否则后续会出现未定义符号的错误。在tasks.json的args数组末尾添加：

"-L/opt/homebrew/Cellar/sfml/2.6.0/lib",
"-lsfml-graphics",
"-lsfml-window",
"-lsfml-system"

（-L指定库文件路径，-l后跟库名，SFML基础图形程序至少需要这三个库）

4. 可选：使用Homebrew默认链接路径（更省心） #

Homebrew安装的库会在/opt/homebrew/include和/opt/homebrew/lib下创建软链接，无需写具体版本号，后续SFML更新版本也不用修改配置。可以把tasks.json里的头文件和库路径改为：

"-I/opt/homebrew/include",
"-L/opt/homebrew/lib",

同时c_cpp_properties.json的includePath里也可以替换为"/opt/homebrew/include"，去掉原来的具体版本路径。

修改后的tasks.json示例 #

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "process",
            "label": "C/C++: clang++ build active file",
            "command": "/usr/bin/clang++",
            "args": [
                "-fcolor-diagnostics",
                "-fansi-escape-codes",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                "-I/opt/homebrew/include",
                "-I${workspaceFolder}",
                "-I${workspaceFolder}/include/boost",
                "-L/opt/homebrew/lib",
                "-lsfml-graphics",
                "-lsfml-window",
                "-lsfml-system"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build",
            "detail": "compiler: /usr/bin/clang++"
        }
    ]
}

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