MacOS + VSCode配置C/C++环境

2023-09-14 20:42

短信预约 -IT技能 免费直播动态提醒

1.背景

C/C++项目的构建编译方式有多种，如在Windows平台上直接使用Visual Studio IDE集成的编译工具链进行构建编译，或CMake进行构建编译。当然，如果对于跨平台的IDE，可选Visual Studio Code（简称VSCode）。本文将针对VSCode配置C/C++的2种构建编译方式以及相关问题进行介绍，即VSCode自有C/C++构建编译模式配置和CMake构建编译模式配置。

2.在VSCode上的两种C/C++构建编译配置

2.1. 方式一：VSCode自有C/C++构建编译模式配置

个人推测该配置模式为微软官方仿照Visual Studio IDE的C/C++设计的。

（1）详细配置过程，请参考文档和配套视频。

（2）.vscode隐藏目录中的三个配置文件示例

c_cpp_properties.json（编译器路径和智能代码提示配置文件）
该文件主要负责编译器的路径设置和代码智能提示，个人感觉该文件的参数配置并不影响项目编译。这里，参数macFrameworkPath、compilerPath、compilerArgs可设置为CommandLineTools的C/C++环境，也可以设置为XCode自带的C/C++环境（如下示例）。

{    "configurations": [        {            "name": "Mac-C",            "includePath": [                "/usr/local/include",                "${workspaceFolder}/**"            ],            "defines": [],            "macFrameworkPath": [                "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks"            ],            "compilerPath": "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang",            "cStandard": "c11",            "cppStandard": "c++14",            "intelliSenseMode": "macos-clang-x64",            "compilerArgs": [                "-L/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/lib"            ]        },        {            "name": "Mac-C++",            "includePath": [                "/usr/local/include",                "${workspaceFolder}/**"            ],            "defines": [],            "macFrameworkPath": [            "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks"            ],            "compilerPath": "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang++",            "cStandard": "c11",            "cppStandard": "c++14",            "intelliSenseMode": "macos-clang-x64",            "compilerArgs": [                "-L/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/lib"            ]        }    ],    "version": 4}

如果，基于CommandLineTools的C/C++环境设置参数macFrameworkPath、compilerPath、compilerArgs，则有：

"macFrameworkPath": ["/Library/Developer/CommandLineTools/SDKs/MacOSX12.sdk/System/Library/Frameworks"],"compilerPath": "/Library/Developer/CommandLineTools/usr/bin/g++","compilerArgs": ["-L/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/lib"],

tasks.json（编译器构建配置文件）
该文件主要用于编译参数的配置。这里的command、args的最后一个参数-L/***、detail均可参考c_cpp_properties.json中对应参数设置。

{"version": "2.0.0","tasks": [{"type": "cppbuild","label": "C/C++: clang++ 生成活动文件","command": "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang++","args": ["-std=c++14","-fcolor-diagnostics","-fansi-escape-codes","-g","${workspaceFolder}/*.cpp","-o","${workspaceFolder}/${workspaceRootFolderName}","-L/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/lib"],"options": {"cwd": "${fileDirname}"},"problemMatcher": ["$gcc"],"group": "build","detail": "编译器: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang++"}]}

launch.json（调试器设置配置文件）
该文件用于代码调试配置。

{    // 使用 IntelliSense 了解相关属性。     // 悬停以查看现有属性的描述。    // 欲了解更多信息，请访问 https://go.microsoft.com/fwlink/?linkid=830387    "version": "0.2.0",    "configurations": [        {            "name": "(lldb) 启动",            "type": "cppdbg",            "request": "launch",            "program": "${workspaceFolder}/${workspaceRootFolderName}",            "args": [],            "stopAtEntry": false,            "cwd": "${fileDirname}",            "environment": [],            "externalConsole": false,            "MIMode": "lldb"        }    ]}

注意一：

c_cpp_properties.json和tasks.json这两个文件的配置项实际上是相互独立的。它们之间没有强制性的依赖关系。也就是说，c_cpp_properties.json 的配置项并不会影响 tasks.json，而 tasks.json 的配置项也不会影响 c_cpp_properties.json。

不过，在实际使用中，这两个文件的配置项可能会有一些重叠的部分，例如编译器的路径、编译选项等。这时候，你需要确保这些重叠部分的配置项是一致的，以避免可能的问题和错误。