VS Code配置C/C++环境

本文内容参考文章Visual Studio Code 如何编写运行 C、C++ 程序?,此文章过于详细,摘其要成此文。
同时可以从VS Code官方文档获得参考与帮助:C++ programming with Visual Studio Code。

下载编译器

笔者由于安装过CodeBlocks,直接使用它的编译器,只需要将编译器bin文件夹(保证gcc.exe在此文件夹中)添加到系统环境变量中即可。
在cmd中使用gcc命令进行测试。
使用gcc -v命令查看编译器版本。

如果需要下载编译器,可以访问:MinGW-w64 - for 32 and 64 bit Windows,推荐下载 x86_64-posix-seh

补充知识:

  • MinGW是gcc在Windows下的移植,gcc是世界上最流行的C/C++编译器组合。但gcc这个名字也指编译C语言的那个程序,g++才是C++编译器。即gcc程序和g++程序包含在gcc套件以及MinGW里,当只说gcc时要根据语境自己区分
  • 其实MinGW和MinGW-w64只是名字像,它们是两个不同的项目
  • MinGW还活着,但只能产生32位程序
  • 现在MinGW-w64很久没有发布官方构建了,代码其实已经更新到了9.2.0,所以也可以考虑用基于它的TDM-GCC64。别下旧版,那是很久以前的,2020年发布了新版扩展是extension,插件是plugin,VSC用的是前者这种称呼

安装扩展

必要扩展:

  • C/C++:又名 cpptools,提供Debug和Format功能
  • Code Runner:右键即可编译运行单文件,很方便,但无法Debug

可选扩展:

  • Bracket Pair Colorizer 2:彩虹花括号
  • One Dark Pro:大概是VS Code安装量最高的主题

配置json文件

VSCode打开文件夹时,会检索文件夹中的.vscode隐藏文件夹,并通过其中的.json进行配置。

创建编写C或C++代码的文件夹,C和C++要分别创建单独的文件夹。
在C和C++文件夹中再创建名为.vscode文件夹,在这个文件夹中放入三个文件:launch.jsontasks.jsonsettings.json
编辑这三个文件,按照需要自行修改。

launch.json

https://code.visualstudio.com/docs/cpp/launch-json-reference

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,
            "internalConsoleOptions": "neverOpen",
            "MIMode": "gdb",
            "miDebuggerPath": "gdb.exe",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": false
                }
            ],
            "preLaunchTask": "Compile"
        }
    ]
}
属性 描述
name 配置名称,将会在启动配置的下拉菜单中显示
type 配置类型,对于C/C++可认为此处只能是cppdbg,由cpptools提供;不同编程语言不同
request 可以为launch(启动)或attach(附加)
program 将要进行调试的程序的路径
args 程序调试时传递给程序的命令行参数,一般设为空
stopAtEntry 设为true时程序将暂停在程序入口处,相当于在main上打断点
cwd 调试程序时的工作目录,此为工作区文件夹;改成${fileDirname}可变为文件所在目录
environment 环境变量
externalConsole 使用单独的cmd窗口,与其它IDE一致;为false时使用内置终端
internalConsoleOptions 如果不设为neverOpen,调试时会跳到“调试控制台”选项卡,你应该不需要对gdb手动输命令吧?
MIMode 指定连接的调试器,可以为gdb或lldb。但我没试过lldb
miDebuggerPath 调试器路径,Windows下后缀不能省略,Linux下则不要
setupCommands 模板自带,好像可以更好地显示STL容器的内容,具体作用自行Google
preLaunchTask 调试前执行的任务,一般为编译程序。与tasks.json的label相对应

tasks.json

https://code.visualstudio.com/docs/editor/tasks

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Compile",
            "command": "gcc",
            "args": [
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}.exe",
                "-g",
                "-m64",
                "-Wall",
                "-static-libgcc",
                "-fexec-charset=GBK",
                "-D__USE_MINGW_ANSI_STDIO",
            ],
            "type": "process",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "presentation": {
                "echo": true,
                "reveal": "always",
                "focus": false,
                "panel": "shared"
            },
            "problemMatcher": "$gcc"
        }
    ]
}
属性 描述
label 任务名称,与launch.json的preLaunchTask相对应
command 要使用的编译器,C++用g++
args 编译的命令,其实相当于VSC帮你在终端中输了这些东西
type process是把预定义变量和转义解析后直接全部传给command;shell相当于先打开shell再输入命令,所以args还会经过shell再解析一遍
reveal 执行任务时是否跳转到终端面板,可以为always,silent,never。具体参见VSC的文档,即使设为never,手动点进去还是可以看到
focus 设为true后可以使执行task时焦点聚集在终端,但对编译C/C++来说,设为true没有意义
panel 不同的文件的编译信息共享一个终端面板
problemMatcher 捕捉编译时终端里的报错信息到问题面板中,修改代码后需要重新编译才会再次触发

settings.json

{
    "files.defaultLanguage": "c",
    "editor.formatOnType": true,
    "editor.suggest.snippetsPreventQuickSuggestions": false,
    "editor.acceptSuggestionOnEnter": "off",
    "code-runner.runInTerminal": true,
    "code-runner.executorMap": {
        "c": "gcc '$fileName' -o '$fileNameWithoutExt.exe' -Wall -O2 -m64 -lm -static-libgcc -fexec-charset=GBK -D__USE_MINGW_ANSI_STDIO && &'./$fileNameWithoutExt.exe'",
        "cpp": "g++ '$fileName' -o '$fileNameWithoutExt.exe' -Wall -O2 -m64 -static-libgcc -fexec-charset=GBK && &'./$fileNameWithoutExt.exe'"
    },
    "code-runner.saveFileBeforeRun": true,
    "code-runner.preserveFocus": true,
    "code-runner.clearPreviousOutput": false,
    "code-runner.ignoreSelection": true,
    "code-runner.fileDirectoryAsCwd": true,
    "C_Cpp.clang_format_sortIncludes": true
}
属性 描述
files.defaultLanguage ctrl+N新建文件后默认的语言
editor.formatOnType 输入分号(C/C++的语句结束标识)后自动格式化当前这一行的代码
editor.suggest.snippetsPreventQuickSuggestions clangd的snippets有很多的跳转点,不用这个就必须手动触发Intellisense了
editor.acceptSuggestionOnEnter 我个人的习惯,按回车时一定是真正的换行,只有tab才会接受Intellisense
editor.snippetSuggestions (可选)snippets显示在补全列表顶端,默认是inline,可改成top
code-runner.runInTerminal 设置成false会在“输出”中输出,无法输入
code-runner.executorMap 右键run code时运行的命令;未注释的仅适用于PowerShell(Win10默认)和pwsh,文件名中有空格也可以编译运行;注释掉的适用于cmd(win7默认)、PS和bash,但文件名中有空格时无法运行
code-runner.saveFileBeforeRun run code前保存
code-runner.preserveFocus 若为false,run code后光标会聚焦到终端上。如果需要频繁输入数据可设为false
code-runner.clearPreviousOutput 每次run code前清空属于code runner的终端消息,默认false
code-runner.ignoreSelection 默认为false,效果是鼠标选中一块代码后可以单独执行,但C是编译型语言,不适合这样用
code-runner.fileDirectoryAsCwd 将code runner终端的工作目录切换到文件目录再运行,对依赖cwd的程序产生影响;如果为false,executorMap要加cd $dir
C_Cpp.clang_format_sortIncludes 格式化时调整include的顺序(按字母排序)

c_cpp_properties.json

如果你需要引用第三方库,则需要添加并编辑此文件,否则不需要。建议先跳过此步。

{
  "configurations": [
    {
      "name": "GCC",
      "includePath": ["${workspaceFolder}/**"],
      "defines": ["_DEBUG", "UNICODE", "_UNICODE"],
      "windowsSdkVersion": "10.0.18362.0",
      "compilerPath": "C:/Program Files/mingw-w64/x86_64-8.1.0-posix-seh-rt_v6-rev0/mingw64/bin/g++.exe",
      "cStandard": "c11",
      "intelliSenseMode": "gcc-x64"
    }
  ],
  "version": 4
}

代码格式化

笔者设置的是在换行和保存时自动格式化文件。

偏好为大括号不换行,tab为四个空格。
C_Cpp: Clang_format_fallback Style设置项中设置{BasedOnStyle: Google, IndentWidth: 4}

你可能感兴趣的:(VS Code配置C/C++环境)