1. 從零開(kāi)始為什么選擇VS Code寫(xiě)C語(yǔ)言如果你剛接觸編程或者從其他IDE比如Dev-C、Code::Blocks轉(zhuǎn)過(guò)來(lái)可能會(huì)覺(jué)得用VS Code寫(xiě)C語(yǔ)言有點(diǎn)“折騰”。畢竟它不像那些專門(mén)的C/C IDE裝好就能一鍵編譯運(yùn)行。但恰恰是這份“折騰”才是你真正理解編程環(huán)境、告別“傻瓜式”操作的第一步。我見(jiàn)過(guò)太多同學(xué)在學(xué)校的機(jī)房里用著配置好的環(huán)境寫(xiě)代碼一旦換到自己的電腦上就寸步難行問(wèn)題出在哪就出在只知道點(diǎn)“運(yùn)行”按鈕卻不知道背后編譯器、調(diào)試器、路徑這些概念是怎么串聯(lián)起來(lái)的。VS Code本身只是一個(gè)強(qiáng)大的文本編輯器它輕量、快速、插件生態(tài)豐富。用它來(lái)寫(xiě)C語(yǔ)言意味著你需要親手搭建一個(gè)“工作臺(tái)”選擇編譯器、配置構(gòu)建任務(wù)、設(shè)置調(diào)試環(huán)境。這個(gè)過(guò)程本質(zhì)上就是在學(xué)習(xí)一個(gè)C/C項(xiàng)目從源代碼到可執(zhí)行文件的完整生命周期。當(dāng)你自己走通一遍以后遇到任何環(huán)境問(wèn)題你都能心中有數(shù)知道該從哪個(gè)環(huán)節(jié)去排查。這比直接用一個(gè)封裝好的“黑箱”IDE對(duì)你的長(zhǎng)期成長(zhǎng)要有益得多。網(wǎng)上相關(guān)的教程很多但要么過(guò)于簡(jiǎn)略跳過(guò)了關(guān)鍵細(xì)節(jié)要么版本老舊已經(jīng)不適用。今天我就以一個(gè)從零開(kāi)始的小白視角帶你走一遍完整的配置流程。我們會(huì)用到MinGW-w64作為編譯器這是Windows平臺(tái)上一個(gè)非常流行且活躍的GCC工具鏈發(fā)行版。我們的目標(biāo)不僅僅是“配通”而是要讓你明白每一步在做什么以及為什么這么做。這樣即使未來(lái)VS Code或相關(guān)插件更新了你也能舉一反三自己調(diào)整。2. 基石準(zhǔn)備安裝編譯器與配置系統(tǒng)環(huán)境變量在VS Code里寫(xiě)代碼它自己并不會(huì)編譯。編譯的工作需要交給一個(gè)獨(dú)立的編譯器Compiler。對(duì)于C語(yǔ)言我們選擇GCC。在Windows上獲取GCC最方便的方式就是安裝MinGW-w64。2.1 下載并安裝MinGW-w64首先忘掉那些名字里帶“MinGW”的老舊安裝包。我們要去MinGW-w64的官方發(fā)布頁(yè)面下載。訪問(wèn)下載頁(yè)面打開(kāi)瀏覽器訪問(wèn) MinGW-w64的SourceForge發(fā)布頁(yè) 。這個(gè)頁(yè)面列表可能看起來(lái)有點(diǎn)復(fù)雜別慌。選擇正確的版本我們需要進(jìn)入Toolchains targetting Win32/64這個(gè)目錄然后進(jìn)入Personal Builds-mingw-builds。在這里你會(huì)看到很多以版本號(hào)命名的文件夾選擇一個(gè)較新的版本比如8.1.0。找到安裝器在版本文件夾內(nèi)找到x86_64-posix-seh這個(gè)架構(gòu)的安裝包。簡(jiǎn)單解釋一下x86_64表示這是64位的編譯器能生成64位的程序?，F(xiàn)在主流電腦都是64位系統(tǒng)選這個(gè)。posix表示使用POSIX線程模型這與后續(xù)可能用到的多線程編程兼容性更好通常推薦。seh異常處理模型對(duì)于大多數(shù)應(yīng)用來(lái)說(shuō)seh性能較好。 所以我們下載的文件名類似x86_64-8.1.0-release-posix-seh-rt_v6-rev0.7z。這是一個(gè)7z壓縮包。解壓到合適位置下載完成后用7-Zip或Bandizip等工具解壓。關(guān)鍵一步將解壓出來(lái)的mingw64文件夾移動(dòng)到一個(gè)你不會(huì)輕易刪除的路徑下并且路徑中最好不要有中文或空格。我個(gè)人的習(xí)慣是放在C:\Tools\mingw64。這樣完整的編譯器路徑就是C:\Tools\mingw64\bin。注意網(wǎng)上有些教程會(huì)讓你下載在線安裝器mingw-get-setup.exe那個(gè)版本通常較舊且安裝過(guò)程可能因網(wǎng)絡(luò)問(wèn)題失敗。直接下載編譯好的離線包是最穩(wěn)妥的方式。2.2 配置系統(tǒng)環(huán)境變量PATH安裝好編譯器后系統(tǒng)并不知道它的存在。我們需要告訴系統(tǒng)“嘿當(dāng)你需要找gcc、g、gdb這些命令時(shí)來(lái)這個(gè)文件夾里找?！?這個(gè)“告訴”的過(guò)程就是配置環(huán)境變量PATH。打開(kāi)系統(tǒng)屬性在Windows搜索框輸入“查看高級(jí)系統(tǒng)設(shè)置”并打開(kāi)。進(jìn)入環(huán)境變量點(diǎn)擊下方的“環(huán)境變量”按鈕。編輯用戶變量在“用戶變量”區(qū)域這只影響當(dāng)前用戶更安全找到并選中名為Path的變量點(diǎn)擊“編輯”。添加新路徑點(diǎn)擊“新建”然后將你剛才放置的mingw64\bin的完整路徑粘貼進(jìn)去。例如C:\Tools\mingw64\bin。驗(yàn)證安裝這是至關(guān)重要的一步能避免后續(xù)90%的“命令找不到”問(wèn)題。打開(kāi)一個(gè)全新的命令提示符CMD或 PowerShell 窗口一定要新開(kāi)讓系統(tǒng)重新讀取環(huán)境變量。輸入以下命令并回車gcc --version g --version gdb --version如果每一條命令都成功輸出了版本信息如下圖示例那么恭喜你編譯器安裝和環(huán)境變量配置成功如果提示“不是內(nèi)部或外部命令”請(qǐng)返回檢查路徑是否正確、是否在編輯Path后新開(kāi)了終端。gcc (x86_64-posix-seh-rev0, Built by MinGW-W64 project) 8.1.0 Copyright (C) 2018 Free Software Foundation, Inc. ...3. 搭建工作區(qū)安裝VS Code與核心插件編譯器就位后我們來(lái)布置代碼編輯的“主戰(zhàn)場(chǎng)”。3.1 安裝VS Code從 VS Code官網(wǎng) 下載安裝包過(guò)程很簡(jiǎn)單一路下一步即可。建議安裝時(shí)勾選“添加到PATH”選項(xiàng)這樣以后可以在任意文件夾右鍵選擇“通過(guò)Code打開(kāi)”非常方便。3.2 安裝必備的C/C插件打開(kāi)VS Code點(diǎn)擊左側(cè)活動(dòng)欄的擴(kuò)展圖標(biāo)或按CtrlShiftX。在搜索框中輸入C找到由Microsoft發(fā)布的名為C/C的插件點(diǎn)擊安裝。這個(gè)插件提供了代碼智能感知IntelliSense、語(yǔ)法高亮、錯(cuò)誤提示、跳轉(zhuǎn)到定義、查看引用等核心功能是C/C開(kāi)發(fā)的基石。僅僅有這個(gè)插件我們可以寫(xiě)代碼但還不能方便地編譯和調(diào)試。為了更高效我們通常還會(huì)配合使用Code Runner插件。3.3 安裝Code Runner插件可選但推薦在擴(kuò)展商店搜索Code Runner作者是Jun Han安裝它。這個(gè)插件可以讓你快速運(yùn)行多種語(yǔ)言的代碼片段。安裝后你會(huì)在代碼編輯區(qū)的右上角看到一個(gè)三角形的“運(yùn)行”按鈕。它的默認(rèn)行為是調(diào)用系統(tǒng)環(huán)境中配置好的命令來(lái)編譯運(yùn)行對(duì)于C語(yǔ)言就是調(diào)用gcc。但是Code Runner的默認(rèn)運(yùn)行方式有一個(gè)問(wèn)題它是在集成終端里一次性執(zhí)行編譯和運(yùn)行命令如果程序需要等待用戶輸入比如用scanf默認(rèn)設(shè)置下輸入窗口會(huì)一閃而過(guò)。我們需要對(duì)其進(jìn)行配置。在VS Code中按CtrlShiftP打開(kāi)命令面板輸入Preferences: Open Settings (JSON)并選擇。這會(huì)打開(kāi)用戶設(shè)置的JSON文件。在JSON文件中添加或修改以下配置{ // 其他已有配置... code-runner.runInTerminal: true, // 在集成終端中運(yùn)行方便交互 code-runner.saveFileBeforeRun: true, // 運(yùn)行前自動(dòng)保存文件 code-runner.executorMap: { // 覆蓋C語(yǔ)言的執(zhí)行命令使用更清晰的編譯和運(yùn)行步驟 c: cd $dir gcc $fileName -o $fileNameWithoutExt $dir$fileNameWithoutExt, }, // 如果你希望運(yùn)行完程序后終端不立即關(guān)閉便于查看輸出可以添加 code-runner.preserveFocus: false, // 運(yùn)行后焦點(diǎn)保持在終端 }這段配置的意思是對(duì)于.c文件先切換到文件所在目錄 (cd $dir)然后用gcc編譯源文件 ($fileName)生成的可執(zhí)行文件去掉后綴 (-o $fileNameWithoutExt)最后運(yùn)行這個(gè)可執(zhí)行文件。4. 深入核心配置IntelliSense與調(diào)試環(huán)境C/C插件和Code Runner讓我們可以寫(xiě)和運(yùn)行代碼但對(duì)于一個(gè)完整的開(kāi)發(fā)體驗(yàn)尤其是調(diào)試Debug來(lái)說(shuō)還不夠。我們需要?jiǎng)?chuàng)建VS Code能理解的配置文件。4.1 理解配置文件c_cpp_properties.json這個(gè)文件用于告訴C/C插件你的編譯器在哪里、包含路徑頭文件路徑是什么、使用什么標(biāo)準(zhǔn)等。它是實(shí)現(xiàn)精準(zhǔn)代碼提示和錯(cuò)誤檢查的關(guān)鍵。在你的項(xiàng)目文件夾比如D:\MyCProjects下用VS Code打開(kāi)。按CtrlShiftP輸入C/C: Edit Configurations (UI)并選擇。這會(huì)打開(kāi)一個(gè)圖形化界面。在界面中主要配置以下兩項(xiàng)編譯器路徑點(diǎn)擊下拉箭頭VS Code會(huì)自動(dòng)在系統(tǒng)PATH中尋找。你應(yīng)該能看到我們之前配置的gcc.exe的完整路徑如C:\Tools\mingw64\bin\gcc.exe。選擇它。IntelliSense 模式選擇gcc-x64。配置完成后VS Code會(huì)在項(xiàng)目文件夾下的.vscode子文件夾中自動(dòng)生成一個(gè)c_cpp_properties.json文件。你也可以直接編輯這個(gè)JSON文件進(jìn)行更高級(jí)的配置比如添加自定義的包含路徑{ configurations: [ { name: Win32, includePath: [ ${workspaceFolder}/**, // 工作區(qū)內(nèi)所有文件 C:/Tools/mingw64/x86_64-w64-mingw32/include // MinGW自帶的系統(tǒng)頭文件路徑 ], compilerPath: C:/Tools/mingw64/bin/gcc.exe, cStandard: c17, // 使用C17標(biāo)準(zhǔn) cppStandard: c17, intelliSenseMode: windows-gcc-x64 } ], version: 4 }4.2 配置構(gòu)建任務(wù)tasks.jsonCode Runner可以運(yùn)行單文件但對(duì)于復(fù)雜項(xiàng)目或者你想自定義編譯參數(shù)如優(yōu)化等級(jí)、警告級(jí)別就需要配置構(gòu)建任務(wù)。在VS Code中打開(kāi)你的.c文件。按CtrlShiftP輸入Tasks: Configure Task然后選擇Create tasks.json file from template再選擇Others。這會(huì)創(chuàng)建一個(gè)最基礎(chǔ)的任務(wù)模板。將內(nèi)容替換為以下配置{ version: 2.0.0, tasks: [ { label: C/C: gcc build active file, // 任務(wù)名稱顯示在列表中 type: shell, // 在shell中執(zhí)行 command: gcc, args: [ -fdiagnostics-coloralways, // 彩色診斷信息 -g, // 生成調(diào)試信息這是調(diào)試的關(guān)鍵 ${file}, // 當(dāng)前活動(dòng)文件 -o, // 指定輸出文件 ${fileDirname}/${fileBasenameNoExtension}.exe, -Wall, // 開(kāi)啟大部分警告 -Wextra, // 開(kāi)啟額外警告 -pedantic // 嚴(yán)格遵守ISO C標(biāo)準(zhǔn) ], group: { kind: build, isDefault: true // 設(shè)為默認(rèn)構(gòu)建任務(wù) }, presentation: { echo: true, reveal: always, // 總是顯示輸出面板 focus: false, panel: shared }, problemMatcher: [$gcc] // 使用gcc的問(wèn)題匹配器可以將編譯錯(cuò)誤鏈接到代碼行 } ] }配置好后你可以按CtrlShiftB來(lái)執(zhí)行這個(gè)默認(rèn)的構(gòu)建任務(wù)。它會(huì)在集成終端中編譯你的代碼并生成帶調(diào)試信息的.exe文件。-Wall -Wextra參數(shù)能讓編譯器告訴你更多潛在的代碼問(wèn)題對(duì)養(yǎng)成良好編碼習(xí)慣非常有幫助。4.3 配置調(diào)試launch.json這是實(shí)現(xiàn)VS Code強(qiáng)大調(diào)試功能的核心。調(diào)試允許你設(shè)置斷點(diǎn)、逐行執(zhí)行、查看變量值是排查邏輯錯(cuò)誤的利器。切換到VS Code的“運(yùn)行和調(diào)試”視圖左側(cè)活動(dòng)欄的三角蟲(chóng)子圖標(biāo)或按CtrlShiftD。點(diǎn)擊“創(chuàng)建一個(gè) launch.json 文件”選擇C (GDB/LLDB)。在出現(xiàn)的配置下拉框中選擇C/C: gcc build and debug active file。VS Code會(huì)自動(dòng)生成一個(gè)launch.json文件。這個(gè)自動(dòng)生成的配置通常已經(jīng)能用但為了更清晰我們可以稍作修改和了解{ version: 0.2.0, configurations: [ { name: (gdb) Launch, // 調(diào)試配置名稱 type: cppdbg, request: launch, program: ${fileDirname}/${fileBasenameNoExtension}.exe, // 要調(diào)試的程序?qū)?yīng)tasks.json生成的exe args: [], // 可以在這里添加命令行參數(shù) stopAtEntry: false, // 是否在main函數(shù)入口處暫停 cwd: ${workspaceFolder}, environment: [], externalConsole: false, // 使用VS Code內(nèi)置終端而非彈出外部控制臺(tái) MIMode: gdb, miDebuggerPath: C:/Tools/mingw64/bin/gdb.exe, // 指定gdb路徑 setupCommands: [ { description: Enable pretty-printing for gdb, text: -enable-pretty-printing, ignoreFailures: true } ], preLaunchTask: C/C: gcc build active file // 調(diào)試前先執(zhí)行哪個(gè)構(gòu)建任務(wù)這里對(duì)應(yīng)tasks.json的label } ] }關(guān)鍵點(diǎn)preLaunchTask將調(diào)試和構(gòu)建關(guān)聯(lián)起來(lái)。當(dāng)你按F5開(kāi)始調(diào)試時(shí)VS Code會(huì)先執(zhí)行tasks.json中l(wèi)abel為C/C: gcc build active file的任務(wù)即用-g參數(shù)編譯然后再啟動(dòng)調(diào)試器。5. 實(shí)戰(zhàn)演練編寫(xiě)、構(gòu)建與調(diào)試你的第一個(gè)程序現(xiàn)在所有工具都已就緒讓我們通過(guò)一個(gè)簡(jiǎn)單的例子來(lái)驗(yàn)證整個(gè)流程。創(chuàng)建項(xiàng)目文件夾與文件在D:\MyCProjects下新建一個(gè)hello文件夾用VS Code打開(kāi)這個(gè)文件夾。新建一個(gè)文件命名為hello.c。編寫(xiě)代碼在hello.c中輸入以下代碼#include stdio.h #include stdlib.h int main() { int a 5; int b 10; int sum a b; printf(Hello, World!\n); printf(The sum of %d and %d is: %d\n, a, b, sum); // 用于演示調(diào)試 for(int i 0; i 5; i) { printf(Counting... %d\n, i); } return 0; }使用Code Runner快速運(yùn)行點(diǎn)擊編輯器右上角的三角形“運(yùn)行”按鈕或按CtrlAltN。你會(huì)在下方的“輸出”面板或集成終端中看到程序運(yùn)行結(jié)果。這是最快捷的運(yùn)行方式。使用構(gòu)建任務(wù)編譯按CtrlShiftB。你會(huì)在終端看到gcc的編譯命令和執(zhí)行過(guò)程。這會(huì)在當(dāng)前目錄生成hello.exe文件。你可以手動(dòng)在終端輸入.\hello.exe來(lái)運(yùn)行它。啟動(dòng)調(diào)試在printf(The sum of %d and %d is: %d\n, a, b, sum);這一行的左側(cè)灰色區(qū)域點(diǎn)擊設(shè)置一個(gè)斷點(diǎn)會(huì)出現(xiàn)紅點(diǎn)。按F5或點(diǎn)擊“運(yùn)行和調(diào)試”視圖的綠色三角按鈕開(kāi)始調(diào)試。程序會(huì)運(yùn)行到斷點(diǎn)處暫停。此時(shí)你可以在左側(cè)“變量”窗口查看a,b,sum的當(dāng)前值。將鼠標(biāo)懸停在代碼中的變量上查看其值。使用頂部的調(diào)試控制欄或快捷鍵進(jìn)行繼續(xù)(F5)、單步跳過(guò)(F10)、單步進(jìn)入(F11)、單步跳出(ShiftF11)等操作。在“調(diào)試控制臺(tái)”可以輸入表達(dá)式求值例如輸入a 100回車看看。繼續(xù)執(zhí)行觀察循環(huán)過(guò)程。6. 進(jìn)階配置與常見(jiàn)問(wèn)題排坑指南基礎(chǔ)流程走通后你可能會(huì)遇到一些個(gè)性化需求或“坑”。這里分享幾個(gè)常見(jiàn)的進(jìn)階配置和問(wèn)題解決方法。6.1 處理多文件項(xiàng)目與自定義頭文件當(dāng)你的項(xiàng)目包含多個(gè).c文件和自定義的.h頭文件時(shí)簡(jiǎn)單的gcc file.c就不夠了。方法一手動(dòng)編譯鏈接。在tasks.json中修改args將多個(gè)源文件一起編譯args: [ -g, ${fileDirname}/main.c, ${fileDirname}/utils.c, -o, ${fileDirname}/program.exe, -I${fileDirname}/include, // -I 指定自定義頭文件搜索目錄 -Wall ]方法二使用Makefile推薦。對(duì)于更復(fù)雜的項(xiàng)目學(xué)習(xí)編寫(xiě)簡(jiǎn)單的Makefile是更好的選擇。你可以在項(xiàng)目根目錄創(chuàng)建Makefile然后修改tasks.json的command為makeargs留空。這樣構(gòu)建任務(wù)就交給了make工具來(lái)管理依賴關(guān)系。6.2 IntelliSense報(bào)錯(cuò)“無(wú)法打開(kāi)源文件”或波浪線即使配置了c_cpp_properties.json有時(shí)VS Code仍然會(huì)對(duì)標(biāo)準(zhǔn)庫(kù)頭文件如stdio.h報(bào)紅提示找不到。檢查編譯器路徑確保compilerPath絕對(duì)正確并且指向的gcc.exe確實(shí)存在。重新掃描編譯器按CtrlShiftP運(yùn)行C/C: Rescan IntelliSense Database命令。清除緩存并重啟有時(shí)IntelliSense的緩存會(huì)出錯(cuò)。可以運(yùn)行C/C: Reset IntelliSense Database命令或者直接刪除項(xiàng)目.vscode文件夾下的.browse.vc.db和.ipch文件夾如果存在然后重啟VS Code。手動(dòng)指定包含路徑如前面c_cpp_properties.json示例所示將MinGW的系統(tǒng)頭文件路徑通常是編譯器路徑/../x86_64-w64-mingw32/include明確添加到includePath中。6.3 調(diào)試時(shí)無(wú)法輸入外部控制臺(tái)問(wèn)題如果你在調(diào)試需要用戶輸入如scanf,getchar的程序時(shí)發(fā)現(xiàn)輸入無(wú)效可能是因?yàn)閘aunch.json中externalConsole: true會(huì)彈出一個(gè)黑色的控制臺(tái)窗口但輸入焦點(diǎn)可能有問(wèn)題。建議將其設(shè)為false使用VS Code的內(nèi)置集成終端進(jìn)行輸入輸出兼容性更好。6.4 中文編碼與輸出亂碼這是一個(gè)Windows終端的老問(wèn)題。如果你的源代碼文件是UTF-8編碼VS Code默認(rèn)而Windows控制臺(tái)默認(rèn)使用GBK編碼輸出中文時(shí)就會(huì)亂碼。解決方案一推薦讓源代碼和終端都使用UTF-8。確保你的.c文件保存為UTF-8編碼VS Code右下角可以查看和更改。修改編譯器參數(shù)在tasks.json的args中添加-fexec-charsetUTF-8告訴gcc生成使用UTF-8字符集的可執(zhí)行文件。修改VS Code終端編碼在用戶設(shè)置settings.json中添加terminal.integrated.profiles.windows: { PowerShell: { source: PowerShell, args: [-NoExit, /c, chcp 65001] // 設(shè)置代碼頁(yè)為UTF-8 } }, terminal.integrated.defaultProfile.windows: PowerShell解決方案二將源代碼保存為GBK編碼不推薦不利于跨平臺(tái)。6.5 插件沖突與性能問(wèn)題如果你安裝了多個(gè)C/C相關(guān)插件可能會(huì)引起功能沖突或性能下降。保持工作環(huán)境的簡(jiǎn)潔通常只保留官方的C/C插件和Code Runner即可。如果遇到代碼提示卡頓可以嘗試在settings.json中調(diào)整IntelliSense引擎C_Cpp.intelliSenseEngine: default, // 或嘗試 Tag Parser 如果“default”太慢 C_Cpp.autocomplete: enabled, C_Cpp.errorSquiggles: enabled配置環(huán)境就像搭積木每一步都建立在之前步驟穩(wěn)固的基礎(chǔ)上。從安裝編譯器、配置環(huán)境變量到安裝插件、編寫(xiě)三個(gè)核心的JSON配置文件最后通過(guò)實(shí)戰(zhàn)和排坑來(lái)鞏固。這個(gè)過(guò)程初期可能會(huì)遇到一些挫折但一旦你親手搭建成功并理解了每個(gè)環(huán)節(jié)的作用你就擁有了一個(gè)完全受自己掌控的、強(qiáng)大的C語(yǔ)言開(kāi)發(fā)環(huán)境。這套環(huán)境不僅適用于學(xué)習(xí)也足以應(yīng)對(duì)許多小型的個(gè)人項(xiàng)目。最重要的是你獲得的不僅僅是配置好的VS Code更是對(duì)開(kāi)發(fā)工具鏈的深刻理解這份能力會(huì)讓你在未來(lái)的編程道路上走得更穩(wěn)、更遠(yuǎn)。