Visual Studio Code 配置C/C++环境

0. 前言

VS Code 是微软发布一款跨平台的源代码编辑器,其拥有强大的功能和丰富的扩展,使之能适合编写许多语言。

本文面向初学者(但不是纯小白),分享一点我配置C/C++的经验。

本文所有内容均可从VS Code的官方文档:C++ programming with Visual Studio Code 以及各个扩展的文档中获得,并且他们还会进行更新。

我的环境:64位Windows 10。VS Code的配置文件在Linux下应该也是通用的,但需要修改路径等部位配置。

1. 环境的准备

VS Code的官网和下载、安装最新的版本。VS Code只是一个编辑器,并不是IDE(集成开发环境)。不含编译器(和许多其它功能),所以编译器要自己安装好。如果想用其他工具链或单纯用官方扩展。

然后下载安装MinGW-w64,其实MinGW和MinGW-w64只是名字像,它们是两个不同的项目。为了方便,本文中的MinGW指的其实都是MinGW-w64。MinGW本身已经很久没有更新了,故不推荐。下载以下两个程序(都要):

下载好了以后安装。添加环境变量时:选Add LLVM to the system PATH for all users(即第二项,不过第三项也差不多)。Clang的安装路径(Destination folder)我推荐填C:\Program Files\LLVM,不装那里也行,下面的配置里路径就自己改。安装完了以后可能会弹出cmd说MSVC integration install failed。这个是因为Clang默认使用的是msvc的工具链,而我们选择的工具链是MinGW,所以就不用管这个提示

MinGW随便装哪,Architecture选x86_64,装好以后把东西全部复制到Clang的文件夹里去,他们会无冲突合并。同样,不做这一步也行,下面的配置里路径就自己改,还要手动把MinGW的bin文件夹加到path中,因为MinGW不会自己加。至于为什么既要装Clang又要装MinGW,是因为Clang没有头文件。然后就可以把MinGW删了(Uninstall.exe)。不建议安装多个MinGW,如果你安装了其他IDE需要注意把其他的MinGW从环境变量中去掉;也可以自己把他们的编译器设为Clang。因为几乎所有的轻量级IDE用的都是MinGW或TDM-GCC,它们不制造编译器,只是打包了一个。而且它们用在VSC里也会有奇怪的错误。

运行cmd,输clang,应该会提示no input files而不是“不是内部命令或外部命令”或者“无法将“clang”项识别为 cmdlet、函数、脚本文件或可运行程序的名称”。输clang -v或gcc -v可以显示出各自的版本。如果是“不是内部命令或外部命令”,说明clang.exe在的文件夹(我的是C:\Program Files\LLVM\bin)没有在环境变量中,要加到path里才行。

配置环境变量

下面我们来配置系统环境
在我的电脑上右键点击属性,然后依次点击下面图片的操作,将MinGW中的bin文件夹路径添加进去(我的路径为 D:\Program Files\MinGW\bin)
之后一直点击确定即可
[注]:设置完系统环境变量之后需要重启vs code

需要安装的扩展:

  • C/C++(就是有些教程里的cpptools)
  • C/C++ Clang Command Adapter:提供静态检测(Lint),很重要
  • Code Runner:右键即可编译运行单文件,很方便

其他可选扩展:

  • Bracket Pair Colorizer:彩虹花括号
  • Include Autocomplete:提供头文件名字的补全
  • C/C++ Snippets:Snippets即重用代码块,效果自己百度;这个扩展安装量虽高,不过个人感觉用处实在不大,你也可以选择其他的Snippets扩展甚至自己定义
  • One Dark Pro:大概是VS Code安装量最高的主题
  • vscode-clangd:这个和Adapter二选一,出得比Adapter晚,下载量也低,但却是llvm官方出的。出现问题时可以换着试试

不建议/不需要装的扩展:

  • GBKtoUTF8:把GBK编码的文档转换成UTF8编码的。此扩展可能有严重的bug,参见第6点,总之不建议装
  • C++ Intellisense:用的是gtags,本文第一个版本的选择。效果非常非常一般。
  • C/C++ Advanced Lint:即cppflylint,本文第二个版本的选择。会产生许多奇怪的警告。总之“过时”了
  • Clang-Format:Adapter包含了此功能

2. 配置四个.json文件

先创建一个你打算存放代码的文件夹(称作工作区),路径不能含有中文和空格和引号。c语言和c++需要建立不同的工作区(除非你懂得下面json文件的某些选项,则可以做到一个工作区使用不同的build task)。

打开VS Code,选打开文件夹(不要选“添加工作区文件夹”,理由见上一句),选择刚才那个文件夹,点VS Code上的新建文件夹,名称为.vscode(这样做的原因是Windows的Explorer不允许创建的文件夹第一个字符是点),然后创建 launch.json,tasks.json,settings.json,c_cpp_properties.json放到.vscode文件夹下,效果图:

launch.json代码:

stopAtEntry可根据自己喜好修改;cwd可以控制程序运行时的相对路径,如有需要可以改为${fileDirname}。其他无需更改,除非你不用windows,则可以用lldb调试(需要自己装)。type和request不变色是正常现象。

 1 // https://github.com/Microsoft/vscode-cpptools/blob/master/launch.md
 2 {
 3     "version": "0.2.0",
 4     "configurations": [
 5         {
 6             "name": "(gdb) Launch", // 配置名称,将会在启动配置的下拉菜单中显示
 7             "type": "cppdbg", // 配置类型,这里只能为cppdbg
 8             "request": "launch", // 请求配置类型,可以为launch(启动)或attach(附加)
 9             "program": "${fileDirname}/${fileBasenameNoExtension}.exe", // 将要进行调试的程序的路径
10             "args": [], // 程序调试时传递给程序的命令行参数,一般设为空即可
11             "stopAtEntry": true, // 设为true时程序将暂停在程序入口处,我一般设置为true
12             "cwd": "${workspaceFolder}", // 调试程序时的工作目录
13             "environment": [], // (环境变量?)
14             "externalConsole": true, // 调试时是否显示控制台窗口,一般设置为true显示控制台
15             "internalConsoleOptions": "neverOpen", // 如果不设为neverOpen,调试时会跳到“调试控制台”选项卡,你应该不需要对gdb手动输命令吧?
16             "MIMode": "gdb", // 指定连接的调试器,可以为gdb或lldb。但目前lldb在windows下没有预编译好的版本。
17             "miDebuggerPath": "gdb.exe", // 调试器路径。
18             "setupCommands": [
19                 {
20                     "description": "Enable pretty-printing for gdb",
21                     "text": "-enable-pretty-printing",
22                     "ignoreFailures": false
23                 }
24             ],
25             "preLaunchTask": "Compile" // 调试会话开始前执行的任务,一般为编译程序。与tasks.json的label相对应
26         }
27     ]
28 }

tasks.json代码:

reveal可根据自己喜好修改,即使设为never,也只是编译时不跳转到“终端”而已,手动点进去还是可以看到,我个人设为never。

命令行参数方面,-std根据自己的需要修改。如果使用Clang编写C语言,把command的值改成clang。

如果使用MinGW,编译C用gcc,编译c++用g++,并把-target和-fcolor那两条删去。如果不想要额外警告,把-Wall那一条删去。

参数的作用我加了注释,还看不懂,百度gcc使用教程。

 1 // https://code.visualstudio.com/docs/editor/tasks
 2 {
 3     "version": "2.0.0",
 4     "tasks": [
 5         {
 6             "label": "Compile", // 任务名称,与launch.json的preLaunchTask相对应
 7             "command": "clang++", // 要使用的编译器
 8             "args": [
 9                 "${file}",
10                 "-o", // 指定输出文件名,不加该参数则默认输出a.exe
11                 "${fileDirname}/${fileBasenameNoExtension}.exe",
12                 "-g", // 生成和调试有关的信息
13                 "-Wall", // 开启额外警告
14                 "-static-libgcc", // 静态链接
15                 "-fcolor-diagnostics",
16                 "--target=x86_64-w64-mingw", // 默认target为msvc,不加这一条就会找不到头文件
17                 "-std=c++17" // C语言最新标准为c11,或根据自己的需要进行修改
18             ], // 编译命令参数
19             "type": "shell",
20             "group": {
21                 "kind": "build",
22                 "isDefault": true // 设为false可做到一个tasks.json配置多个编译指令,需要自己修改本文件,我这里不多提
23             },
24             "presentation": {
25                 "echo": true,
26                 "reveal": "always", // 在“终端”中显示编译信息的策略,可以为always,silent,never。具体参见VSC的文档
27                 "focus": false, // 设为true后可以使执行task时焦点聚集在终端,但对编译c和c++来说,设为true没有意义
28                 "panel": "shared" // 不同的文件的编译信息共享一个终端面板
29             }
30             // "problemMatcher":"$gcc" // 如果你不使用clang,去掉前面的注释符,并在上一条之后加个逗号。照着我的教程做的不需要改(也可以把这行删去)
31         }
32     ]
33 }

settings.json代码:

把这个文件里的东西放到“用户设置”里也可以覆盖全局设置,自己进行选择。

Code Runner的命令行和某些选项可以根据自己的需要在此处修改,用法还是参见此扩展的文档和百度gcc使用教程。

如果你要使用其他地方的头文件和库文件,可能要往clang.cflags和clang.cxxflags里加-I和-L,用法百度gcc使用教程。

clang的补全,在我过去的测试过程中会让VSC非常卡,但是现在好像没有这个问题了。

如果你卡,就把clang的补全关掉,用cpptools的。

Linux下去掉code runner和flags的--target那一条,共四个。

{
    "files.defaultLanguage": "cpp", // ctrl+N新建文件后默认的语言
    "editor.formatOnType": true, // 输入时就进行格式化,默认触发字符较少,分号可以触发
    "editor.snippetSuggestions": "top", // snippets代码优先显示补全

    "code-runner.runInTerminal": true, // 设置成false会在“输出”中输出,无法输入
    "code-runner.executorMap": {
        "c": "cd $dir && clang $fileName -o $fileNameWithoutExt.exe -Wall -g -Og -static-libgcc -fcolor-diagnostics --target=x86_64-w64-mingw -std=c11 && $dir$fileNameWithoutExt",
        "cpp": "cd $dir && clang++ $fileName -o $fileNameWithoutExt.exe -Wall -g -Og -static-libgcc -fcolor-diagnostics --target=x86_64-w64-mingw -std=c++17 && $dir$fileNameWithoutExt"
    }, // 设置code runner的命令行
    "code-runner.saveFileBeforeRun": true, // run code前保存
    "code-runner.preserveFocus": true, // 若为false,run code后光标会聚焦到终端上。如果需要频繁输入数据可设为false
    "code-runner.clearPreviousOutput": false, // 每次run code前清空属于code runner的终端消息

    "C_Cpp.clang_format_sortIncludes": true, // 格式化时调整include的顺序(按字母排序)
    "C_Cpp.intelliSenseEngine": "Default", // 可以为Default或Tag Parser,后者较老,功能较简单。具体差别参考cpptools扩展文档
    "C_Cpp.errorSquiggles": "Disabled", // 因为有clang的lint,所以关掉
    "C_Cpp.autocomplete": "Disabled", // 因为有clang的补全,所以关掉

    "clang.cflags": [ // 控制c语言静态检测的参数
        "--target=x86_64-w64-mingw",
        "-std=c11",
        "-Wall"
    ],
    "clang.cxxflags": [ // 控制c++静态检测时的参数
        "--target=x86_64-w64-mingw",
        "-std=c++17",
        "-Wall"
    ],
    "clang.completion.enable":true // 效果效果比cpptools要好
}

c_cpp_properties.json代码:

此文件内容来自于Microsoft/vscode-cpptools;这个json不允许有注释(其实按照标准本来就不能有)。

如果你没有合并Clang和MinGW,则该文件中的compilerPath必需修改成MinGW的完整路径,精确到gcc.exe,否则会提示找不到头文件;Linux下应该是/usr/bin/gcc。

如果你自己编写了头文件又不在workspaceFolder下,路径也要加到includePath和browse里。这些路径是否递归有效暂时未知,我的测试是有效的。

Windows下的路径为反斜杠,原本应使用两个反斜杠来转义,但直接用斜杠在VS Code中也接受。

{
    "configurations": [
        {
            "name": "MinGW",
            "intelliSenseMode": "clang-x64",
            "compilerPath": "C:/Program Files/LLVM/bin/gcc.exe",
            "includePath": [
                "${workspaceFolder}"
            ],
            "defines": [],
            "browse": {
                "path": [
                    "${workspaceFolder}"
                ],
                "limitSymbolsToIncludedHeaders": true,
                "databaseFilename": ""
            },
            "cStandard": "c11",
            "cppStandard": "c++17"
        }
    ],
    "version": 4
}

为什么要往json里写这么多的东西?因为VSC本身并没有对C语言特别优待,对其他许多语言也是这样。另外稍微提一下,以$开头的是VSC预定义的变量,具体参见:Variables Reference

关于VS Code输出会出现乱码,很多人都遇到过。这是因为VS Code内部用的是utf-8编码,cmd/powershell是gbk编码。直接编译,会把“你好”输出成“浣犲ソ”。
其实可以点右下角 选Reopen with Encoding 选Chinese GBK 就可以正常输入中文了,而且输出也是正常的
还可以在设置里搜索encode,把files.encoding改成gbk,而且最好把files.autoGuessEncoding也改成true

本文主要在作者:谭九鼎 (链接)的基础上简化。

 

原文地址:https://www.cnblogs.com/esllovesn/p/10012653.html

时间: 2024-11-06 18:02:01

Visual Studio Code 配置C/C++环境的相关文章

Visual Studio Code 配置VUE开发环境

简介 VSCode(Visual Studio Code)这款开发工具是微软官方出品,开源,免费.功能相当强大.插件丰富,使用者很多,是Vue开发的不二之选.下面讲解下VSCode 配置VUE开发环境 下载 官方:https://code.visualstudio.com/ 在官方下载安装包,点击操作按照指导进行安装就可以,过程比较简单,这里不进行详细介绍. 概念讲解(Workspace&Folder) VSCode中分Workspace和Folder,Workspace相当于是一个项目的集合,

Visual Studio Code 配置Go 开发环境最简单的方法!!!

由于大家都知道的原因,在国内如果想访问go等各种资源,都会遇到某种不可预知的神奇问题.导致在VS Code中安装 go 各种插件都会失败. 于是乎,网上就出现了各种各样的解决方案:什么手动git clone, 手动建立golang.org/x目录等等,更有 有心之人,专门研究了下VS Code的插件机制. 我觉得最根本的办法还是要解决上面那个神奇问题.配置一个代理是最方便的了. 然后,一切都清静了 下次有时间再说说如何手动弄个代理吧 原文地址:https://www.cnblogs.com/ye

Windows下visual studio code搭建golang开发环境

Windows下visual studio code搭建golang开发环境 序幕 其实环境搭建没什么难的,但是遇到一些问题,主要是有些网站资源访问不了(如:golang.org),导致一些包无法安装,最终会导致环境搭建失败,跟据这个教程几步,我们将可以快速的构建golang的开发环境. 开发环境: 一.安装 这里我用需要安装一些工具: 1.Visual Studio Code 1.0.0 2.Golang下载 这里我使用的是Go1.6. 3.git下载 这一步跟建环境没什么关系, 但是之后要引

Visual Studio Code中JavaScript开发环境的配置

Visual Studio Code简称VS Code,是一款由微软公司免费开源的现代化轻量级代码编辑器,几乎支持所有的主流开发语言的语法高亮.自定义热键.代码片段.括号匹配等诸多特性,还支持插件扩展,并针对网页开发和云端应用开发做了优化.下面简单介绍一下VS Code中JavaScript开发环境的配置. 首先在微软官网上下载安装好VS Code后并打开,在扩展商店中安装插件,直接Ctrl+Shift+X打开扩展商店,在搜索框中搜索Code Runner和Debugger for Chrome

Visual Studio Code配置C++环境

1 介绍 最近发现了一款很好用的代码编辑器,Visual Studio Code,是微软开源出来的,下载链接是https://code.visualstudio.com/ ,在window下适用这个,感觉简直太好了,之前一直使用它作为markdown编辑器,只需要安装一个插件就可以了.但是如果需要配置其他环境,则除了安装插件以外还需要进行适当的配置.本文主要介绍的是C++环境配置. 2 步骤 2.1 安装插件 点击左侧的扩展窗口,在搜索栏搜索C++,安装该插件.如下图,图中已经安装好了. 2.2

Visual Studio Code C / C++ 语言环境配置的历程

前言 从大一开始学习c++用的dev-c++,后来看到老师用的是vs  code,实在是馋它的颜值便去下了vs  2017.至于为什么下载vs 2017呢?是因为下载的时候我以为他们是一样的,便下了vs  2017,好家伙下了我好几个G.体积大我还是可以接受的,但是每次写题的时候都要去建个项目,一建就是一个文件夹,而且写main函数的时候前面还要引用头标.实在是太麻烦了,写的代码还不好管理.以至于我在后来我改用vs code.vs  code比起vs  2017来说是轻便得多,写单个的代码方便了

Visual Studio Code 配置指南

Visual Studio Code (简称 VS Code)是由微软研发的一款免费.开源的跨平台文本(代码)编辑器.在我看来它是「一款完美的编辑器」. 本文是有关 VS Code 的特性介绍与配置指南,相关设置主要针对 Mac OS X 平台.在快捷键部分, ? 指 Command 键,? 指 Shift 键,? 指 Control 键,? 指 Option/Alt 键. 1. Visual Studio Code 特性简介 1.1 Git 集成 如上图所示,VS Code 默认集成了 Git

Visual Studio Code 配置 gulp

原本用的webstorm部署的gulp,后来由于太卡,打算换个编辑器,考虑了一番,之前用的是sublime,配置很是麻烦,最新听说饥人谷老师用的是vsCode,所以打算尝试一下这个编辑器,安装还是很方便的,不需要破解,直接下载,安装,就可以用了,然后开始配置gulp,百度搜了下,有配置gulp的先例,但是配置的过程分享的非常的少,寥寥几字,看后实在不知所措. 前提,我的gulp是全局安装的,gulp相关的插件也在终端上安装好了,所以,就算是换编辑器,我认为也不用再重复安装了. 打开vscode,

Visual Studio Code搭建python开发环境

开发Python的环境有很多,原来已经在vs2013上面搭建好python的开发环境了,但是vs2013每次启动都占太多内存(太强大了吧),这下出了vs code,既轻量又酷炫,正好拿来试一试开发python,点击visual studio code1.9安装教程 下面直接上搭建Python环境步骤: 1.打开vs code,按按F1或者Ctrl+Shift+P打开命令行,然后输入ext install 输入Python,选第一个,这个用的最多,支持自动补全代码等功能,点击安装按钮,即可安装 下