windows下用vscode寫C++

【本文參考：https://www.cnblogs.com/zhuzhenwei918/p/9057289.html  和 https://www.zhihu.com/question/30315894，本人根據自己實際需要修改】

【官方教程：https://code.visualstudio.com/docs/languages/cpp】

windows下用vscode寫C++

1. 環境准備
2. 安裝vscode插件
3. 工作區配置文件
4. 運行
5. 調試
6. 配置好的模板下載

1.環境准備

• 下載VsCode安裝即可。
• LLVM Download Page 在此頁面下載Clang。選Pre-Built Binaries中的Clang for Windows (64-bit)，不需要下.sig文件。使用clang作為編譯器
• MinGW-w64 - for 32 and 64 bit Windows 在此頁面下載MinGW-w64，目的是使用其中的頭文件

MinGW裝好以后把東西全部復制到Clang的文件夾里去，他們會 無沖突合並。同樣，不做這一步也行，下面的配置里路徑就自己改，還要手動把MinGW的bin文件夾加到path中，因為MinGW不會自己加。至於為什么既要裝Clang又要裝MinGW，是因為Clang沒有頭文件。然后就可以把MinGW刪了（Uninstall.exe）。 不建議安裝多個MinGW，如果你安裝了其他IDE需要注意把其他的MinGW從環境變量中去掉；也可以自己把他們的編譯器設為Clang。因為幾乎所有的輕量級IDE用的都是MinGW或TDM-GCC，它們不制造編譯器，只是打包了一個。而且它們用在VSC里也會有奇怪的錯誤。

2.安裝vscode插件

需要安裝的擴展：

• C/C++
• C++ Intellisense
• 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官方出的。出現問題時可以換着試試

3.工作區vscode配置文件

即在vscode中打開文件夾->創建新的文件夾->選中，這樣就直接加入到vscode中了；或者直接把一個文件拖入vscode中；假設我們新建的文件夾名稱為Foo。

接着，在這個Foo下創建一個.vscode文件夾，這是必須的（一般來說，每個文件夾中都會有這么一個.vscode配置文件）。注意：將此文件夾放在常用文件夾頂層，就不需要重復配置了。

在.vscode文件夾中，新建三個（只需三個）配置文件，即c_cpp_properties.json（C++編譯器相關配置）、launch.json（debug相關配置）、tasks.json（任務編譯相關配置）和settings.json（非必要，項目設置）。然后內容如下：

c_cpp_properties.json：

此文件內容來自於Microsoft/vscode-cpptools；這個json不允許有注釋（其實按照標准本來就不能有）。如果你沒有合並Clang和MinGW，則該文件中的compilerPath必需修改成MinGW的完整路徑，精確到gcc.exe，否則會提示找不到頭文件；Linux下應該是/usr/bin/gcc。如果你自己編寫了頭文件又不在workspaceFolder下，路徑也要加到includePath和browse里。這些路徑是否遞歸有效暫時未知，我的測試是有效的。Windows下的路徑為反斜杠，原本應使用兩個反斜杠來轉義，但直接用斜杠在VS Code中也接受。

When you set the compilerPath property and change intelliSenseMode to clang-x64, you no longer need to copy the system include path or defines to includePath, browse.path, or defines to enable IntelliSense to work properly.

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

 

launch.json文件（注意：其中的miDebuggerPath可能也是不一樣的，需要注意）：

stopAtEntry可根據自己喜好修改；cwd可以控制程序運行時的相對路徑，如有需要可以改為 ${fileDirname} 。其他無需更改，除非你不用windows，則可以用lldb調試（需要自己裝）。type和request不變色是正常現象。

// https://github.com/Microsoft/vscode-cpptools/blob/master/launch.md
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch", // 配置名稱，將會在啟動配置的下拉菜單中顯示
            "type": "cppdbg", // 配置類型，這里只能為cppdbg
            "request": "launch", // 請求配置類型，可以為launch（啟動）或attach（附加）
            "program": "${fileDirname}/${fileBasenameNoExtension}.exe", // 將要進行調試的程序的路徑
            "args": [], // 程序調試時傳遞給程序的命令行參數，一般設為空即可
            "stopAtEntry": false, // 設為true時程序將暫停在程序入口處，我一般設置為true
            "cwd": "${workspaceFolder}", // 調試程序時的工作目錄
            "environment": [], // （環境變量？）
            "externalConsole": true, // 調試時是否顯示控制台窗口，一般設置為true顯示控制台
            "internalConsoleOptions": "neverOpen", // 如果不設為neverOpen，調試時會跳到“調試控制台”選項卡，你應該不需要對gdb手動輸命令吧？
            "MIMode": "gdb", // 指定連接的調試器，可以為gdb或lldb。但目前lldb在windows下沒有預編譯好的版本。
            "miDebuggerPath": "C:/Program Files/LLVM/bin/gdb.exe", // 調試器路徑，Windows下后綴不能省略，Linux下則去掉
            "setupCommands": [ // 用處未知，模板如此
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": false
                }
            ],
            "preLaunchTask": "Compile" // 調試會話開始前執行的任務，一般為編譯程序。與tasks.json的label相對應
        }
    ]
}

 

tasks.json（這個所有都一樣，無需個性化修改）：

命令行參數方面，-std根據自己的需要修改。如果使用Clang編寫C語言，把command的值改成clang。如果使用MinGW，編譯C用gcc，編譯c++用g++，並把-target和-fcolor那兩條刪去。如果不想要額外警告，把-Wall那一條刪去。參數的作用我加了注釋，還看不懂，百度gcc使用教程。

// https://code.visualstudio.com/docs/editor/tasks
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Compile", // 任務名稱，與launch.json的preLaunchTask相對應
            "command": "clang++", // 要使用的編譯器
            "args": [
                "${file}",
                "-o", // 指定輸出文件名，不加該參數則默認輸出a.exe，Linux下默認a.out
                "${fileDirname}/${fileBasenameNoExtension}.exe",
                "-g", // 生成和調試有關的信息
                "-Wall", // 開啟額外警告
                "-static-libgcc", // 靜態鏈接
                "-fcolor-diagnostics", // 彩色的錯誤信息？但貌似clang默認開啟而gcc不接受此參數
                "--target=x86_64-w64-mingw", // clang的默認target為msvc，不加這一條就會找不到頭文件；Linux下去掉這一條
                "-std=c++17" // C語言最新標准為c11，或根據自己的需要進行修改
            ], // 編譯命令參數
            "type": "shell", // 可以為shell或process，前者相當於先打開shell再輸入命令，后者是直接運行命令
            "group": {
                "kind": "build",
                "isDefault": true // 設為false可做到一個tasks.json配置多個編譯指令，需要自己修改本文件，我這里不多提
            },
            "presentation": {
                "echo": true,
                "reveal": "always", // 在“終端”中顯示編譯信息的策略，可以為always，silent，never。具體參見VSC的文檔
                "focus": false, // 設為true后可以使執行task時焦點聚集在終端，但對編譯c和c++來說，設為true沒有意義
                "panel": "shared" // 不同的文件的編譯信息共享一個終端面板
            }
            // "problemMatcher":"$gcc" // 如果你不使用clang，去掉前面的注釋符，並在上一條之后加個逗號。照着我的教程做的不需要改（也可以把這行刪去)
        }
    ]
}

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要好
}

 

4. 運行

下面是一個簡單程序的例子，可以通過這個例子來演示vscode的使用，點擊運行即可。

#include <iostream>
#include <vector>
using namespace std;

int main() {
    cout << "hedy, I love you!" << endl;
    vector<int> a;
    a.push_back(5);
    cout << a[0] << endl;
    return 0;
}

 

5.調試

可以在代碼左邊打斷點，查看變量值等。

6.配置好的模板下載

一個配置好的vscode模板，點擊下載。