建站
咨詢
售后
建站咨詢
新聞中心
0. 前言
VS Code 是微軟發(fā)布一款跨平臺(tái)的源代碼編輯器，其擁有強(qiáng)大的功能和豐富的擴(kuò)展，使之能適合編寫許多語(yǔ)言。
本文面向初學(xué)者（但不是純小白），分享一點(diǎn)我配置C/C++的經(jīng)驗(yàn)。
本文所有內(nèi)容均可從VS Code的官方文檔：C++ programming with Visual Studio Code 以及各個(gè)擴(kuò)展的文檔中獲得，并且他們還會(huì)進(jìn)行更新。
我的環(huán)境：64位Windows 10。VS Code的配置文件在Linux下應(yīng)該也是通用的，但需要修改路徑等部位配置。
1. 環(huán)境的準(zhǔn)備
VS Code的官網(wǎng)和下載、安裝最新的版本。VS Code只是一個(gè)編輯器，并不是IDE（集成開發(fā)環(huán)境）。不含編譯器（和許多其它功能），所以編譯器要自己安裝好。如果想用其他工具鏈或單純用官方擴(kuò)展。
然后下載安裝MinGW-w64，其實(shí)MinGW和MinGW-w64只是名字像，它們是兩個(gè)不同的項(xiàng)目。為了方便，本文中的MinGW指的其實(shí)都是MinGW-w64。MinGW本身已經(jīng)很久沒(méi)有更新了，故不推薦。下載以下兩個(gè)程序（都要）：
- LLVM Download Page 在此頁(yè)面下載Clang。選Pre-Built Binaries中的Clang for Windows (64-bit)，不需要下.sig文件
- MinGW-w64 - for 32 and 64 bit Windows 在此頁(yè)面下載MinGW-w64，點(diǎn)那個(gè)Download就行
下載好了以后安裝。添加環(huán)境變量時(shí)：選Add LLVM to the system PATH for all users（即第二項(xiàng)，不過(guò)第三項(xiàng)也差不多）。Clang的安裝路徑（Destination folder）我推薦填C:\Program Files\LLVM，不裝那里也行，下面的配置里路徑就自己改。安裝完了以后可能會(huì)彈出cmd說(shuō)MSVC integration install failed。這個(gè)是因?yàn)镃lang默認(rèn)使用的是msvc的工具鏈，而我們選擇的工具鏈?zhǔn)荕inGW，所以就不用管這個(gè)提示。
MinGW隨便裝哪，Architecture選x86_64，裝好以后把東西全部復(fù)制到Clang的文件夾里去，他們會(huì)無(wú)沖突合并。同樣，不做這一步也行，下面的配置里路徑就自己改，還要手動(dòng)把MinGW的bin文件夾加到path中，因?yàn)镸inGW不會(huì)自己加。至于為什么既要裝Clang又要裝MinGW，是因?yàn)镃lang沒(méi)有頭文件。然后就可以把MinGW刪了（Uninstall.exe）。不建議安裝多個(gè)MinGW，如果你安裝了其他IDE需要注意把其他的MinGW從環(huán)境變量中去掉；也可以自己把他們的編譯器設(shè)為Clang。因?yàn)閹缀跛械妮p量級(jí)IDE用的都是MinGW或TDM-GCC，它們不制造編譯器，只是打包了一個(gè)。而且它們用在VSC里也會(huì)有奇怪的錯(cuò)誤。
運(yùn)行cmd，輸clang，應(yīng)該會(huì)提示no input files而不是“不是內(nèi)部命令或外部命令”或者“無(wú)法將“clang”項(xiàng)識(shí)別為 cmdlet、函數(shù)、腳本文件或可運(yùn)行程序的名稱”。輸clang -v或gcc -v可以顯示出各自的版本。如果是“不是內(nèi)部命令或外部命令”，說(shuō)明clang.exe在的文件夾（我的是C:\Program Files\LLVM\bin）沒(méi)有在環(huán)境變量中，要加到path里才行。
配置環(huán)境變量
下面我們來(lái)配置系統(tǒng)環(huán)境
在我的電腦上右鍵點(diǎn)擊屬性，然后依次點(diǎn)擊下面圖片的操作，將MinGW中的bin文件夾路徑添加進(jìn)去（我的路徑為 D:\Program Files\MinGW\bin）
之后一直點(diǎn)擊確定即可
[注]：設(shè)置完系統(tǒng)環(huán)境變量之后需要重啟vs code
需要安裝的擴(kuò)展：
- C/C++（就是有些教程里的cpptools）
- C/C++ Clang Command Adapter：提供靜態(tài)檢測(cè)（Lint），很重要
- Code Runner：右鍵即可編譯運(yùn)行單文件，很方便
其他可選擴(kuò)展：
- Bracket Pair Colorizer：彩虹花括號(hào)
- Include Autocomplete：提供頭文件名字的補(bǔ)全
- C/C++ Snippets：Snippets即重用代碼塊，效果自己百度；這個(gè)擴(kuò)展安裝量雖高，不過(guò)個(gè)人感覺(jué)用處實(shí)在不大，你也可以選擇其他的Snippets擴(kuò)展甚至自己定義
- One Dark Pro：大概是VS Code安裝量最高的主題
- vscode-clangd：這個(gè)和Adapter二選一，出得比Adapter晚，下載量也低，但卻是llvm官方出的。出現(xiàn)問(wèn)題時(shí)可以換著試試
不建議/不需要裝的擴(kuò)展：
- GBKtoUTF8：把GBK編碼的文檔轉(zhuǎn)換成UTF8編碼的。此擴(kuò)展可能有嚴(yán)重的bug，參見第6點(diǎn)，總之不建議裝
- C++ Intellisense：用的是gtags，本文第一個(gè)版本的選擇。效果非常非常一般。
- C/C++ Advanced Lint：即cppflylint，本文第二個(gè)版本的選擇。會(huì)產(chǎn)生許多奇怪的警告?？傊斑^(guò)時(shí)”了
- Clang-Format：Adapter包含了此功能
2. 配置四個(gè).json文件
先創(chuàng)建一個(gè)你打算存放代碼的文件夾（稱作工作區(qū)），路徑不能含有中文和空格和引號(hào)。C語(yǔ)言和c++需要建立不同的工作區(qū)（除非你懂得下面json文件的某些選項(xiàng)，則可以做到一個(gè)工作區(qū)使用不同的build task）。
打開VS Code，選打開文件夾（不要選“添加工作區(qū)文件夾”，理由見上一句），選擇剛才那個(gè)文件夾，點(diǎn)VS Code上的新建文件夾，名稱為.vscode（這樣做的原因是Windows的Explorer不允許創(chuàng)建的文件夾第一個(gè)字符是點(diǎn)），然后創(chuàng)建 launch.json，tasks.json，settings.json，c_cpp_properties.json放到.vscode文件夾下，效果圖：
launch.json代碼：
stopAtEntry可根據(jù)自己喜好修改；cwd可以控制程序運(yùn)行時(shí)的相對(duì)路徑，如有需要可以改為${fileDirname}。其他無(wú)需更改，除非你不用windows，則可以用lldb調(diào)試（需要自己裝）。type和request不變色是正?，F(xiàn)象。
// https://github.com/Microsoft/vscode-cpptools/blob/master/launch.md
{
"version": "0.2.0",
"configurations": [
{
"name": "(gdb) Launch", // 配置名稱，將會(huì)在啟動(dòng)配置的下拉菜單中顯示
"type": "cppdbg", // 配置類型，這里只能為cppdbg
"request": "launch", // 請(qǐng)求配置類型，可以為launch（啟動(dòng)）或attach（附加）
"program": "${fileDirname}/${fileBasenameNoExtension}.exe", // 將要進(jìn)行調(diào)試的程序的路徑
"args": [], // 程序調(diào)試時(shí)傳遞給程序的命令行參數(shù)，一般設(shè)為空即可
"stopAtEntry": true, // 設(shè)為true時(shí)程序?qū)和Ｔ诔绦蛉肟谔帲乙话阍O(shè)置為true
"cwd": "${workspaceFolder}", // 調(diào)試程序時(shí)的工作目錄
"environment": [], // （環(huán)境變量？）
"externalConsole": true, // 調(diào)試時(shí)是否顯示控制臺(tái)窗口，一般設(shè)置為true顯示控制臺(tái)
"internalConsoleOptions": "neverOpen", // 如果不設(shè)為neverOpen，調(diào)試時(shí)會(huì)跳到“調(diào)試控制臺(tái)”選項(xiàng)卡，你應(yīng)該不需要對(duì)gdb手動(dòng)輸命令吧？
"MIMode": "gdb", // 指定連接的調(diào)試器，可以為gdb或lldb。但目前l(fā)ldb在windows下沒(méi)有預(yù)編譯好的版本。
"miDebuggerPath": "gdb.exe", // 調(diào)試器路徑。
"setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": false
}
],
"preLaunchTask": "Compile" // 調(diào)試會(huì)話開始前執(zhí)行的任務(wù)，一般為編譯程序。與tasks.json的label相對(duì)應(yīng)
}
]
}
tasks.json代碼：
reveal可根據(jù)自己喜好修改，即使設(shè)為never，也只是編譯時(shí)不跳轉(zhuǎn)到“終端”而已，手動(dòng)點(diǎn)進(jìn)去還是可以看到，我個(gè)人設(shè)為never。
命令行參數(shù)方面，-std根據(jù)自己的需要修改。如果使用Clang編寫C語(yǔ)言，把command的值改成clang。
如果使用MinGW，編譯C用gcc，編譯c++用g++，并把-target和-fcolor那兩條刪去。如果不想要額外警告，把-Wall那一條刪去。
settings.json代碼：
把這個(gè)文件里的東西放到“用戶設(shè)置”里也可以覆蓋全局設(shè)置，自己進(jìn)行選擇。
clang的補(bǔ)全，在我過(guò)去的測(cè)試過(guò)程中會(huì)讓VSC非?？?，但是現(xiàn)在好像沒(méi)有這個(gè)問(wèn)題了。
如果你卡，就把clang的補(bǔ)全關(guān)掉，用cpptools的。
Linux下去掉code runner和flags的--target那一條，共四個(gè)。
{
"files.defaultLanguage": "cpp", // ctrl+N新建文件后默認(rèn)的語(yǔ)言
"editor.formatOnType": true, // 輸入時(shí)就進(jìn)行格式化，默認(rèn)觸發(fā)字符較少，分號(hào)可以觸發(fā)
"editor.snippetSuggestions": "top", // snippets代碼優(yōu)先顯示補(bǔ)全
"code-runner.runInTerminal": true, // 設(shè)置成false會(huì)在“輸出”中輸出，無(wú)法輸入
"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"
}, // 設(shè)置code runner的命令行
"code-runner.saveFileBeforeRun": true, // run code前保存
"code-runner.preserveFocus": true, // 若為false，run code后光標(biāo)會(huì)聚焦到終端上。如果需要頻繁輸入數(shù)據(jù)可設(shè)為false
"code-runner.clearPreviousOutput": false, // 每次run code前清空屬于code runner的終端消息
"clang.cflags": [ // 控制c語(yǔ)言靜態(tài)檢測(cè)的參數(shù)
"--target=x86_64-w64-mingw",
"-std=c11",
"-Wall"
],
"clang.cxxflags": [ // 控制c++靜態(tài)檢測(cè)時(shí)的參數(shù)
"--target=x86_64-w64-mingw",
"-std=c++17",
"-Wall"
],
"clang.completion.enable":true // 效果效果比cpptools要好
}
c_cpp_properties.json代碼：
此文件內(nèi)容來(lái)自于Microsoft/vscode-cpptools；這個(gè)json不允許有注釋（其實(shí)按照標(biāo)準(zhǔn)本來(lái)就不能有）。
如果你沒(méi)有合并Clang和MinGW，則該文件中的compilerPath必需修改成MinGW的完整路徑，精確到gcc.exe，否則會(huì)提示找不到頭文件；Linux下應(yīng)該是/usr/bin/gcc。
如果你自己編寫了頭文件又不在workspaceFolder下，路徑也要加到includePath和browse里。這些路徑是否遞歸有效暫時(shí)未知，我的測(cè)試是有效的。
Windows下的路徑為反斜杠，原本應(yīng)使用兩個(gè)反斜杠來(lái)轉(zhuǎn)義，但直接用斜杠在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里寫這么多的東西？因?yàn)閂SC本身并沒(méi)有對(duì)C語(yǔ)言特別優(yōu)待，對(duì)其他許多語(yǔ)言也是這樣。另外稍微提一下，以$開頭的是VSC預(yù)定義的變量，具體參見：Variables Reference。
關(guān)于VS Code輸出會(huì)出現(xiàn)亂碼，很多人都遇到過(guò)。這是因?yàn)閂S Code內(nèi)部用的是utf-8編碼，cmd/powershell是gbk編碼。直接編譯，會(huì)把“你好”輸出成“浣犲ソ”。
其實(shí)可以點(diǎn)右下角 選Reopen with Encoding 選Chinese GBK 就可以正常輸入中文了，而且輸出也是正常的
還可以在設(shè)置里搜索encode，把files.encoding改成gbk，而且最好把files.autoGuessEncoding也改成true
本文主要在作者：譚九鼎 （鏈接）的基礎(chǔ)上簡(jiǎn)化。
https://www.zhihu.com/question/30315894/answer/154979413
名稱欄目：VisualStudioCode配置C/C++環(huán)境
網(wǎng)頁(yè)地址：http://www.dlmjj.cn/article/dpispdi.html
