【MAC】vscode C++环境配置学习以及问题解决

intm_

已于 2022-08-11 16:35:42 修改

阅读量1w

点赞数 16

分类专栏： vscode学习文章标签： macos vscode c++

于 2022-08-06 23:15:20 首次发布

本文链接：https://blog.csdn.net/print_gqh/article/details/126190696

版权

vscode学习专栏收录该内容

1 篇文章

订阅专栏

本文详细记录了Mac用户从重新配置VSCode，安装homebrew和opencv，到解决编译器问题和配置多个json文件的过程，包括终端输入问题、vector初始化、多文件编译等，旨在帮助其他开发者避免配置困扰。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

写在前面

我的电脑是macos 10.15.6，之前一直用的是xcode（不得不说，Xcode虽然占内存但是真香！），由于之后需要用到设计编程图形化界面Qt，所以下载vscode与Qt相配。

之前看了大量教程配置vscode，但最后都配得一团糟，最近正好有空闲的时间，所以重新下载了vscode重新配置。

过程实在是太艰辛了，花了我一整天的时间，我把过程及遇到的所有坑都吐血整理如下，希望对你有些帮助。

准备

下载vscode
由于我的电脑上之前已经安装过xcode，所以一些编译工具（如g++,gcc,clang）都具备，若没有需要提前安装。
不怕占内存的话建议直接先安装xcode，一键解决所有编译器问题。
下载homebrew，利用homebrew安装opencv（不确定homebrew在vscode配环境中的作用，如果你没有下载homebrew，可能会遇到一些其他问题），具体homebrew的下载方法也写在后面了。
可以尝试直接跳到配置文件部分，前面的homebrew和opencv可以略过不看，遇到问题再来看。
【不重要】我习惯直接从文件终端中打开ide，所以设置了code .命令的访问方法，具体写在最后。
由于之前下载过vscode，所以一些基本的C++插件已经安装，如C/C++, Code Runner等，若未安装需要先安装

一.（Mac）homebrew安装

用这位老哥的一行代码解决：
Homebrew国内如何自动安装（国内地址）（Mac & Linux）
效果如下：
在这里插入图片描述

关于为什么要下载homebrew：
- homebrew是mac内部一个管理各种包的软件
- 有待学习

二. 利用homebrew安装opencv

有三个步骤：

1. brew install wget
2. brew install cmake
3. brew install opencv

检查安装结果

brew info opencv

按照教程里的步骤，检查结果应该如下：

但是我自己在执行第三步的时候，出现了错误提示：
输入brew info opencv后,提示有一部分未安装成功：

单独对打红叉的进行brew install仍然有错误提示，暂时还未找到解决办法，所以暂且搁置，继续配置环境。

配置完成后发现此处错误不影响后续配置。

三. vscode json文件配置

我用的是clang, 全程参考官网教程，官网上有三个json文件，直接复制即可
mac按[command+shift+p]可以调出控制面板

四. 遇到的问题

感觉Mac配置vscode会遇到的问题是个玄学，网上的各种解决办法是否适用于自己也是个玄学。所以我此处只贴出我遇到的问题以及最终的解决办法（均已解决），和我最终的四个配置文件。

1. 终端无法输入

这个问题在官网有解释：
请添加图片描述

简单来说：

将launch.json文件中的"externalConsole":false一行代码中的false改为true即可，这可以解决一部分人的问题。
若还未解决，继续按照官网教程，在tasks.json中加入如下代码：

{
            "label": "Open Terminal",
            "type": "shell",
            "command": "osascript -e 'tell application \"Terminal\"\ndo script \"echo hello\"\nend tell'",
            "problemMatcher": []
}

之后在Terminal > Run Task … 中选择 Open Terminal，点击后不会跳出什么提示，但是再次运行时就会出现独立终端了。

2. vector容器不可以直接用{}初始化

在按照官网中给出的代码调试时，会出现如下错误提示：

在这里插入图片描述

语法没有错，明显是编译器的编译标准太老了，在近几年的C++新标准（c++17）新出之后，就已经可以对vector定义时进行初始化。

看了网上的解决办法：

若使用了Code Runner插件，可以尝试修改一下code runner插件的指令模板

依次找到:文件>首选项>设置>用户设置>扩展>run code configurate>Executor Map，然后点击在settings.json中编辑

在这里插入图片描述
找到cpp那一行，修改代码为cd $dir && clang++ $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt，若使用的是g++编译器，就将命令中的clang++改为g++,此行代码的具体功能可以参考文档.

我没有使用到Code Runner，所以使用另一种办法，在task.json文件中，加入此行代码：

在launch.json文件中也作相应修改：

问题得到解决。

3. 无法执行新保存的cpp文件

新编辑cpp之后进行保存，但是每次执行的仍然是最初的cpp，并有如下错误提示：
在这里插入图片描述

解决办法是在launch.json中加入"preLaunchTask":"Build"此行代码

请添加图片描述

注意preLaunchTask与tasks.json中的label相对应，所以在tasks.json中也要作相应修改：

请添加图片描述

问题得到解决。

4. 无法多文件编译

多文件编译时会出现ld错误提示。

解决办法：只需要将tasks.json中的参数修改一下即可：
请添加图片描述
若单文件编译就使用第一行参数，多文件编译就使用第二行参数。问题解决。

五. 配置文件

最后，贴出我的四个配置文件。

1. c_cpp_properties.json

{
    "configurations": [
        {
            "name": "Mac",
            "includePath": [
                "${workspaceFolder}/**"
            ],
            "defines": [],
            "macFrameworkPath": [
                "/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks"
            ],
            "compilerPath": "/usr/bin/clang",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "clang-x64"
        }
    ],
    "version": 4
}

2.launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "C/C++: clang++ build and debug active file",
      "type": "cppdbg",
      "request": "launch",
      "program": "${fileDirname}/${fileBasenameNoExtension}",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      "externalConsole": true,
      "MIMode": "lldb",
      "preLaunchTask": "Build"                                            
    }, 
  ]
}

3.tasks.json

{
    "tasks": [
        {
            "type": "cppbuild",
            "label":"Build",
           // "label": "C/C++: clang++ build active file",
            "command": "/usr/bin/clang++",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                //以下二选一
                //"${file}",//用于单文件编译
                "${fileDirname}/*.cpp",//用于多文件编译
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                "-std=c++17"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "Task generated by Debugger."
        },
        {
            "label": "Open Terminal",
            "type": "shell",
            "command": "osascript -e 'tell application \"Terminal\"\ndo script \"echo hello\"\nend tell'",
            "problemMatcher": []
          }
          
    ],
    "version": "2.0.0"
}