Win 10 MSYS2 VS Code 配置 c++ 的編譯環境

博客參考 http://www.javashuo.com/article/p-oqurwbmp-cy.html 和 http://www.javashuo.com/article/p-vdtlcvwf-gp.html

VS Code 是微軟發佈一款跨平臺的源代碼編輯器，其擁有強大的功能和豐富的擴展，使之能適合編寫許多語言。

本文面向初學者（但不是純小白），分享一點我配置C/C++的經驗。

本文全部內容都可從VS Code的官方文檔：C++ programming with Visual Studio Code 以及各個擴展的文檔中得到，而且他們還會進行更新。

個人環境：64位Windows 10。VS Code的配置文件在Linux下應該也是通用的，但須要修改路徑等部位配置。

 

1. 先安裝 MSYS 2 http://www.javashuo.com/article/p-bwlzqalw-gr.html

2.修改msys 源( 不然下載包會失敗)  http://www.javashuo.com/article/p-mqmbjqmd-mo.html

3.下載並安裝 VS Code

4.配置 VS Code 的c++編譯環境，

4.1 選中c++ 相關的配置，會在本地多出一個.vscode的文件，並有 launch.json 文件。這進行配置

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": true, // 設爲true時程序將暫停在程序入口處，我通常設置爲true
            "cwd": "${workspaceFolder}", // 調試程序時的工做目錄
            "environment": [], // （環境變量？）
            "externalConsole": true, // 調試時是否顯示控制檯窗口，通常設置爲true顯示控制檯
            "internalConsoleOptions": "neverOpen", // 若是不設爲neverOpen，調試時會跳到「調試控制檯」選項卡，你應該不須要對gdb手動輸命令吧？
            "MIMode": "gdb", // 指定鏈接的調試器，能夠爲gdb或lldb。但目前lldb在windows下沒有預編譯好的版本。
            "miDebuggerPath": "gdb.exe", // 調試器路徑。
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": false
                }
            ],
            "preLaunchTask": "Compile" // 調試會話開始前執行的任務，通常爲編譯程序。與tasks.json的label相對應
        }
    ]
}

miDebuggerPath 節點的配置，要與本地的路徑一致(因爲我已經將GCC路徑設置爲環境變量，因此這兒直接就是gdb.exe,沒有設置的話能夠配置爲全局路徑便可).配置好了以後，F5啓動調試，這個時候，會讓你配置tasks.json。 會出現，一個下拉框，你隨便選擇一個（目的，是爲了出現 tasks.json 文件），這樣，直接 配置 tasks.json 文件便可；

4.2 配置 tasks.json 文件

reveal可根據本身喜愛修改，即便設爲never，也只是編譯時不跳轉到「終端」而已，手動點進去仍是能夠看到，我我的設爲never。命令行參數方面，-std根據本身的須要修改。若是使用Clang編寫C語言，把command的值改爲clang。若是使用MinGW，編譯C用gcc，編譯c++用g++，並把-target和-fcolor那兩條刪去。若是不想要額外警告，把-Wall那一條刪去。

// https://code.visualstudio.com/docs/editor/tasks
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Compile", // 任務名稱，與launch.json的preLaunchTask相對應
            "command": "g++", // 要使用的編譯器
            "args": [
                "${file}",
                "-o", // 指定輸出文件名，不加該參數則默認輸出a.exe
                "${fileDirname}/${fileBasenameNoExtension}.exe",
                "-g", // 生成和調試有關的信息
                "-Wall", // 開啓額外警告
                "-static-libgcc", // 靜態連接
                "-std=c++17" // C語言最新標準爲c11，或根據本身的須要進行修改
            ], // 編譯命令參數
            "type": "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，去掉前面的註釋符，並在上一條以後加個逗號。照着個人教程作的不須要改（也能夠把這行刪去)
        }
    ]
}

4.3 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": "D:/msys64/mingw32/bin/i686-w64-mingw32-gcc.exe",
            "includePath": [
                "${workspaceFolder}"

            ],
            "defines": [],
            "browse": {
                "path": [
                    "${workspaceFolder}"
                ],
                "limitSymbolsToIncludedHeaders": true,
                "databaseFilename": ""
            },
            "cStandard": "c11",
            "cppStandard": "c++17"
        }
    ],
    "version": 4
}

6.setting.json

把這個文件裏的東西放到「用戶設置」裏也能夠覆蓋全局設置，本身進行選擇。Code Runner 的命令行和某些選項能夠根據本身的須要在此處修改，用法仍是參見此擴展的文檔和百度gcc使用教程。

若是你要使用其餘地方的頭文件和庫文件，可能要往clang.cflags和clang.cxxflags里加-I和-L，用法百度gcc使用教程。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 && gcc $fileName -o $fileNameWithoutExt.exe -Wall -g -Og -static-libgcc -std=c11 && $dir$fileNameWithoutExt",
        "cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt.exe -Wall -g -Og -static-libgcc -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,
    "files.associations": {
        "iostream": "cpp"
    } // 效果效果比cpptools要好
}

爲何要往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