很多大一新生剛開(kāi)始學(xué) C 語(yǔ)言時(shí)第一節(jié)課老師讓大家裝一個(gè)開(kāi)發(fā)工具不少同學(xué)興沖沖地打開(kāi) VS Code寫下了人生第一個(gè)printf(Hello World)然后點(diǎn)擊運(yùn)行結(jié)果彈出的不是運(yùn)行結(jié)果而是一堆看不懂的報(bào)錯(cuò)。有的報(bào)了gcc 不是內(nèi)部或外部命令有的提示找不到stdio.h還有的寫完中文輸出后終端里全是亂碼。網(wǎng)上相關(guān)的教程零散且版本混亂照著配了半天還是不行。這篇教程會(huì)把在 VS Code 中編輯、編譯、運(yùn)行和調(diào)試 C 語(yǔ)言的完整流程拆開(kāi)講清楚從原理、安裝、配置到排錯(cuò)一步步走一遍。不管你是剛接觸編程的大一新生還是想換一個(gè)輕量編輯器寫 C 語(yǔ)言的同學(xué)都可以跟著這篇文章把環(huán)境配好并且知道每一步為什么要這樣做。1. 背景與核心概念1.1 VS Code 到底是什么它是不是一個(gè)編譯器Visual Studio Code簡(jiǎn)稱 VS Code是一個(gè)代碼編輯器它本身并不具備直接運(yùn)行 C 語(yǔ)言的能力。這一點(diǎn)非常重要因?yàn)楹芏鄤傞_(kāi)始學(xué)編程的同學(xué)會(huì)有一個(gè)誤區(qū)覺(jué)得編輯器裝了就能直接運(yùn)行代碼。實(shí)際上C 語(yǔ)言的源碼是給人看的文本文件要讓計(jì)算機(jī)執(zhí)行它需要先把源碼翻譯成機(jī)器能夠識(shí)別的可執(zhí)行程序這個(gè)翻譯工作由“編譯器”完成。在 Windows 上常見(jiàn)的 C 語(yǔ)言編譯器有 MSVCVisual Studio 自帶、MinGW-w64GCC 的 Windows 版本等。VS Code 與編譯器之間的關(guān)系可以理解為“編輯器負(fù)責(zé)寫代碼命令行負(fù)責(zé)編譯運(yùn)行”。VS Code 只是一個(gè)外殼它通過(guò)配置文件去調(diào)用編譯器再把編譯和運(yùn)行的輸出結(jié)果顯示在集成終端中。所以完整的 C 語(yǔ)言開(kāi)發(fā)環(huán)境需要三部分VS Code負(fù)責(zé)編輯源碼、提供語(yǔ)法高亮和代碼提示。編譯器 GCC通常通過(guò) MinGW-w64 獲得負(fù)責(zé)把.c文件編譯成.exe可執(zhí)行文件。終端負(fù)責(zé)執(zhí)行編譯命令和運(yùn)行程序。1.2 為什么大一新生適合用 VS Code 寫 C 語(yǔ)言對(duì)于剛開(kāi)始學(xué) C 語(yǔ)言的大一學(xué)生來(lái)說(shuō)VS Code 最大的優(yōu)點(diǎn)是輕量、界面簡(jiǎn)潔、啟動(dòng)快。相比 Visual Studio 這種動(dòng)輒幾個(gè) GB 的集成開(kāi)發(fā)環(huán)境VS Code 安裝起來(lái)更簡(jiǎn)單內(nèi)存占用更小而且跨平臺(tái)。你在宿舍用自己的 Windows 筆記本配好環(huán)境以后到學(xué)校機(jī)房如果用的是 macOS 或者 Linux也能用幾乎一樣的配置繼續(xù)寫代碼學(xué)習(xí)成本很低。當(dāng)然VS Code 的上手門檻在于需要自己手動(dòng)配置編譯器和 JSON 配置文件。很多同學(xué)恰恰卡在這一步。理解背后的原理之后你會(huì)發(fā)現(xiàn)這其實(shí)并不復(fù)雜而且能加深對(duì)“源文件、編譯器、可執(zhí)行文件”的理解這對(duì)后續(xù)學(xué)習(xí)編譯原理和操作系統(tǒng)也有幫助。1.3 本文的核心知識(shí)點(diǎn)本文講解的內(nèi)容包括在 Windows 上安裝 MinGW-w64 編譯器配置 PATH 環(huán)境變量。安裝 VS Code 必需的 C/C 擴(kuò)展插件。編寫第一個(gè) C 語(yǔ)言程序。通過(guò)終端命令手動(dòng)編譯運(yùn)行 C 文件。配置 VS Code 的編譯任務(wù)和調(diào)試任務(wù)實(shí)現(xiàn)一鍵運(yùn)行與斷點(diǎn)調(diào)試。解決中文亂碼、找不到編譯器、無(wú)法打開(kāi)源文件等常見(jiàn)問(wèn)題。不管你是用 Windows 10 還是 Windows 11步驟基本一致。如果你的系統(tǒng)是 macOS那么編譯器通常使用自帶的 clang配置思路類似但命令細(xì)節(jié)不同本文以 Windows 環(huán)境為主。2. 環(huán)境準(zhǔn)備與版本說(shuō)明2.1 通用的版本注意事項(xiàng)工具的版本會(huì)不斷更新所以這篇教程不會(huì)死板地把版本號(hào)寫死也不會(huì)要求你必須下載某一個(gè)歷史版本。你只需要遵循以下原則即可VS Code 保持官網(wǎng)下載的最新穩(wěn)定版。MinGW-w64 選擇較新的穩(wěn)定版本建議選擇 64 位版本因?yàn)榻^大多數(shù)現(xiàn)代 Windows 都是 64 位系統(tǒng)。C/C 擴(kuò)展插件在 VS Code 擴(kuò)展市場(chǎng)中直接安裝最新版它是 Microsoft 官方發(fā)布的插件。下面演示中涉及的路徑、文件名和配置都是以常見(jiàn)環(huán)境為例。如果你的版本或安裝路徑不同請(qǐng)根據(jù)實(shí)際情況調(diào)整重點(diǎn)是理解“為什么要這樣配置”。2.2 下載并安裝 MinGW-w64 編譯器在 Windows 上獲得 GCC 編譯器比較常見(jiàn)的方式是下載 MinGW-w64。搜索“MinGW-w64”可以找到 SourceForge、GitHub 等平臺(tái)上的發(fā)布頁(yè)面。如果你的網(wǎng)絡(luò)下載速度比較慢也可以搜索國(guó)內(nèi)的一些開(kāi)源鏡像站選擇對(duì)應(yīng)的 MinGW-w64 壓縮包下載。下載得到一個(gè)mingw64壓縮包之后建議把它解壓到一個(gè)路徑簡(jiǎn)單、沒(méi)有中文和空格的地方。例如D:\mingw64解壓完成后打開(kāi)文件夾確認(rèn)內(nèi)部結(jié)構(gòu)。正常情況下你會(huì)看到D:\mingw64\bin這個(gè)bin目錄里含有g(shù)cc.exe、g.exe、gdb.exe等可執(zhí)行文件。其中g(shù)cc.exe是 C 語(yǔ)言編譯器gdb.exe是調(diào)試器。請(qǐng)記住這個(gè)路徑下一步要把bin目錄添加到系統(tǒng)環(huán)境變量中。2.3 配置 PATH 環(huán)境變量為什么需要配置 PATH因?yàn)椴僮飨到y(tǒng)在執(zhí)行命令時(shí)會(huì)在當(dāng)前目錄和 PATH 指定的目錄中搜索對(duì)應(yīng)的可執(zhí)行文件。如果不配置 PATH你在終端里輸入gcc就會(huì)提示“不是內(nèi)部或外部命令”必須輸入完整的絕對(duì)路徑才能調(diào)用編譯器非常麻煩。配置步驟如下按鍵盤快捷鍵Win R輸入sysdm.cpl打開(kāi)“系統(tǒng)屬性”。點(diǎn)擊“高級(jí)”選項(xiàng)卡點(diǎn)擊下方的“環(huán)境變量”。在“系統(tǒng)變量”中找到Path選中后點(diǎn)擊“編輯”。點(diǎn)擊“新建”然后填入你的bin目錄路徑例如D:\mingw64\bin。點(diǎn)擊“確定”保存所有窗口。配置完成以后需要重新打開(kāi)終端窗口讓環(huán)境變量生效。如果你現(xiàn)在正開(kāi)著 VS Code建議完全關(guān)閉后重新打開(kāi)。2.4 驗(yàn)證編譯器是否安裝成功打開(kāi)一個(gè)新的命令行終端。Windows 上可以在開(kāi)始菜單搜索cmd或者直接打開(kāi) Windows PowerShell。輸入以下命令gcc --version如果配置正確終端會(huì)輸出 GCC 的版本信息例如類似gcc (Rev1, Built by MSYS2 project) 13.2.0 Copyright (C) 2023 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.如果你的輸出顯示“不是內(nèi)部或外部命令”說(shuō)明環(huán)境變量沒(méi)有配置對(duì)或者安裝位置有誤。建議回到上一步檢查路徑是否填錯(cuò)然后重新打開(kāi)終端再試一次。2.5 安裝 VS CodeVS Code 官方下載地址是 code.visualstudio.com根據(jù)自己的系統(tǒng)下載 Windows 版安裝包。安裝過(guò)程一路默認(rèn)即可但有兩個(gè)地方建議留意在“選擇附加任務(wù)”這一步建議勾選“添加到 PATH”。建議勾選“Open with Code”這樣在文件夾右鍵菜單里可以直接用 VS Code 打開(kāi)非常方便。如果你之前已經(jīng)安裝了 VS Code可以跳過(guò)這一節(jié)直接進(jìn)入插件安裝環(huán)節(jié)。3. VS Code 插件安裝與基礎(chǔ)設(shè)置3.1 安裝 C/C 擴(kuò)展插件打開(kāi) VS Code 以后點(diǎn)擊左側(cè)邊欄的“擴(kuò)展”圖標(biāo)也可以使用快捷鍵Ctrl Shift X打開(kāi)擴(kuò)展面板。在搜索框中輸入C/C找到由 Microsoft 發(fā)布的插件它的擴(kuò)展 ID 是ms-vscode.cpptools。點(diǎn)擊“Install”安裝。安裝完成以后VS Code 會(huì)針對(duì).c和.cpp文件提供語(yǔ)法高亮、代碼補(bǔ)全、錯(cuò)誤提示、調(diào)試支持等功能。如果沒(méi)有安裝這個(gè)插件雖然也能用 VS Code 打開(kāi)代碼但沒(méi)有代碼提示調(diào)試功能也無(wú)法正常工作。如果你希望更快速地運(yùn)行單個(gè)文件可以額外安裝一個(gè)名為Code Runner的擴(kuò)展它支持一鍵運(yùn)行多種語(yǔ)言。對(duì)于大一學(xué)生來(lái)說(shuō)Code Runner 比較直觀適合快速驗(yàn)證代碼。但在本文中我會(huì)先介紹最標(biāo)準(zhǔn)的編譯方式再介紹調(diào)試配置最后補(bǔ)充 Code Runner 的用法你可以根據(jù)自己的習(xí)慣選擇。3.2 設(shè)置源碼文件編碼C 語(yǔ)言源碼中如果包含中文注釋或中文輸出會(huì)涉及編碼問(wèn)題。Windows 簡(jiǎn)體中文環(huán)境下默認(rèn)的命令行代碼頁(yè)是 936GBK而 VS Code 創(chuàng)建的文件默認(rèn)編碼是 UTF-8。兩者的編碼不一致時(shí)程序運(yùn)行輸出的中文經(jīng)常變成亂碼。這是一個(gè)非常經(jīng)典的問(wèn)題。為了減少干擾在第一次配置環(huán)境時(shí)我們直接在 VS Code 中將文件編碼設(shè)置為 UTF-8同時(shí)讓終端也盡量使用 UTF-8。后面第 6 節(jié)會(huì)專門展開(kāi)亂碼的解決方案。你可以打開(kāi) VS Code 的設(shè)置界面按Ctrl ,搜索files.encoding確認(rèn)默認(rèn)編碼為utf-8。一般默認(rèn)已經(jīng)如此不需要修改。3.3 建立一個(gè) C 語(yǔ)言工作目錄建議專門為 C 語(yǔ)言課程建立一個(gè)文件夾所有代碼都放在里面方便管理。比如在 D 盤建立D:\C-Learning。然后啟動(dòng) VS Code點(diǎn)擊“文件” - “打開(kāi)文件夾”選擇剛才建好的文件夾。也可以直接在文件夾空白處右鍵選擇“Open with Code”。在 VS Code 中新建一個(gè)文件命名為hello.c。剛創(chuàng)建時(shí) VS Code 會(huì)識(shí)別C語(yǔ)言語(yǔ)法模式?，F(xiàn)在我們先不著急寫代碼下一步先把編譯和運(yùn)行的方式搞清楚。4. 編寫第一個(gè) C 語(yǔ)言程序4.1 源文件內(nèi)容在hello.c中輸入以下代碼#include stdio.h int main() { printf(Hello World!\n); return 0; }代碼解釋#include stdio.h是預(yù)處理指令相當(dāng)于把標(biāo)準(zhǔn)輸入輸出庫(kù)的頭文件引入到當(dāng)前源文件中這樣后面的printf函數(shù)才能使用。int main()是程序的入口函數(shù)程序總是從main開(kāi)始執(zhí)行。printf是輸出函數(shù)雙引號(hào)內(nèi)的字符串會(huì)被打印到終端。\n表示換行。return 0;表示程序正常結(jié)束返回給操作系統(tǒng)一個(gè)退出碼。寫完代碼以后按Ctrl S保存文件。4.2 編譯源文件在 VS Code 中打開(kāi)集成終端可以通過(guò)頂部菜單“終端” - “新建終端”或者使用快捷鍵 Ctrl 。確保終端中的當(dāng)前目錄是hello.c所在目錄然后輸入以下命令gcc hello.c -o hello.exe命令解釋gcc是編譯器程序名稱。hello.c是要編譯的源文件。-o參數(shù)指定輸出文件的名稱。hello.exe是生成的可執(zhí)行文件名稱。如果編譯成功終端不會(huì)顯示任何錯(cuò)誤信息并且當(dāng)前目錄下會(huì)多出一個(gè)hello.exe文件。這就是編譯器“翻譯”出來(lái)的機(jī)器可執(zhí)行程序。如果編譯失敗終端會(huì)提示具體的錯(cuò)誤行號(hào)和錯(cuò)誤原因。第一次寫代碼最常見(jiàn)的錯(cuò)誤是漏掉分號(hào)或者中英文符號(hào)混用。比如hello.c: In function main: hello.c:5:5: error: expected ; before return這個(gè)提示已經(jīng)在告訴你第 5 行return前面缺少分號(hào)。這時(shí)候回到編輯器檢查一下把缺掉的分號(hào)加上再重新編譯即可。4.3 運(yùn)行程序編譯成功之后在終端輸入.\hello.exe回車以后終端會(huì)輸出Hello World!這里有個(gè)小細(xì)節(jié)在 Windows 的 PowerShell 或 CMD 中運(yùn)行當(dāng)前目錄下的程序需要在文件名前面加.\表示“從當(dāng)前目錄查找”。如果你直接輸入hello.exe有些版本的系統(tǒng)會(huì)提示找不到命令這是因?yàn)槟J(rèn)搜索路徑不包括當(dāng)前目錄。4.4 編譯和運(yùn)行兩個(gè)步驟的合并每次寫完代碼都要先編譯再運(yùn)行一共兩條命令。對(duì)于練習(xí)階段來(lái)說(shuō)效率確實(shí)不高。后面我們會(huì)通過(guò)配置編譯任務(wù)把這兩步合并成一個(gè)快捷鍵操作。先手動(dòng)敲命令能幫你更好地理解“編譯”和“運(yùn)行”是兩個(gè)完全不同的階段。這里再多說(shuō)一句程序?qū)戝e(cuò)了不要慌。編譯器的報(bào)錯(cuò)信息是學(xué)習(xí)過(guò)程中最重要的老師之一它往往精確指出了行號(hào)和錯(cuò)誤類型。哪怕現(xiàn)在是英文的也要嘗試去讀懂它這是程序員必須慢慢養(yǎng)成的能力。5. 配置 VS Code 一鍵編譯與調(diào)試5.1 為什么需要 tasks.json 和 launch.json手動(dòng)在終端里敲編譯命令雖然可行但不方便尤其是后面學(xué)習(xí)的代碼越來(lái)越復(fù)雜需要調(diào)試、加斷點(diǎn)、看變量值光靠命令行就很吃力了。VS Code 提供了兩個(gè)配置文件tasks.json定義“編譯任務(wù)”告訴 VS Code 如何調(diào)用編譯器生成可執(zhí)行文件。launch.json定義“調(diào)試配置”告訴 VS Code 如何啟動(dòng)調(diào)試器并運(yùn)行程序。配置好以后你在 VS Code 中按一個(gè)快捷鍵就能編譯運(yùn)行設(shè)置斷點(diǎn)后按 F5 就能調(diào)試和 Visual Studio 的使用體驗(yàn)非常接近。5.2 生成 tasks.json在 VS Code 中打開(kāi)hello.c確保當(dāng)前文件處于活動(dòng)狀態(tài)。然后按快捷鍵Ctrl Shift P打開(kāi)命令面板輸入“Tasks: Configure Default Build Task”回車。也可以直接選擇“終端” - “配置默認(rèn)生成任務(wù)”再選擇C/C: gcc.exe 生成活動(dòng)文件。VS Code 會(huì)自動(dòng)生成一個(gè).vscode/tasks.json文件里面包含了默認(rèn)的編譯配置。自動(dòng)生成的內(nèi)容通常類似于{ version: 2.0.0, tasks: [ { type: cppbuild, label: C/C: gcc.exe 生成活動(dòng)文件, command: D:/mingw64/bin/gcc.exe, args: [ -fdiagnostics-coloralways, -g, ${file}, -o, ${fileDirname}\\${fileBasenameNoExtension}.exe ], options: { cwd: ${fileDirname} }, problemMatcher: [ $gcc ], group: { kind: build, isDefault: true }, detail: 編譯器: D:/mingw64/bin/gcc.exe } ] }這里的關(guān)鍵變量解釋如下${file}當(dāng)前活動(dòng)文件的絕對(duì)路徑。${fileDirname}當(dāng)前活動(dòng)文件所在目錄。${fileBasenameNoExtension}當(dāng)前文件名去掉擴(kuò)展名后的名稱例如hello.c對(duì)應(yīng)hello。-g生成調(diào)試信息供調(diào)試器使用。-o指定輸出文件路徑。如果你在環(huán)境變量中已經(jīng)配置好gcc也可以把command改成gcc這樣即使編譯器換了一個(gè)路徑也不影響配置。配置完成后按Ctrl Shift B即可執(zhí)行編譯任務(wù)。此時(shí)終端會(huì)顯示編譯進(jìn)程如果編譯成功不會(huì)出現(xiàn)紅色報(bào)錯(cuò)信息。5.3 生成 launch.json接下來(lái)配置調(diào)試。依然在hello.c活動(dòng)狀態(tài)下按Ctrl Shift P輸入“Debug: Open launch.json”回車。如果 VS Code 提示選擇調(diào)試環(huán)境選擇“C (GDB/LLDB)”。VS Code 會(huì)自動(dòng)生成.vscode/launch.json。我們可以將配置修改為更通用的形式{ version: 0.2.0, configurations: [ { name: C/C 調(diào)試, type: cppdbg, request: launch, program: ${fileDirname}\\${fileBasenameNoExtension}.exe, args: [], stopAtEntry: false, cwd: ${fileDirname}, environment: [], externalConsole: false, MIMode: gdb, miDebuggerPath: gdb, preLaunchTask: C/C: gcc.exe 生成活動(dòng)文件, setupCommands: [ { description: 為 gdb 啟用整齊打印, text: -enable-pretty-printing, ignoreFailures: true } ] } ] }這里的幾個(gè)關(guān)鍵字段說(shuō)明program指定要調(diào)試的可執(zhí)行文件路徑這里和你編譯任務(wù)生成的文件路徑要保持一致。preLaunchTask指定開(kāi)始調(diào)試前先執(zhí)行的編譯任務(wù)確保你每次調(diào)試的都是最新編譯的程序。miDebuggerPath指定調(diào)試器路徑寫成gdb表示從 PATH 中查找如果你的 gdb 不在 PATH 中需要寫成完整路徑例如D:/mingw64/bin/gdb.exe。externalConsole是否在外部控制臺(tái)運(yùn)行程序。如果設(shè)置為true程序會(huì)在一個(gè)新的黑色窗口中運(yùn)行適合需要輸入數(shù)據(jù)的場(chǎng)景。如果設(shè)置為false則在 VS Code 內(nèi)部調(diào)試控制臺(tái)顯示輸出。修改完成后保存文件。5.4 使用快捷鍵編譯和調(diào)試現(xiàn)在回到hello.c源碼按Ctrl Shift B編譯然后在代碼左邊點(diǎn)擊行號(hào)旁邊的空白區(qū)域可以看到紅色圓點(diǎn)這表示設(shè)置了一個(gè)斷點(diǎn)。按F5啟動(dòng)調(diào)試程序會(huì)在斷點(diǎn)處暫停左側(cè)會(huì)出現(xiàn)變量窗口你可以看到當(dāng)前變量的值。繼續(xù)按F10單步執(zhí)行F11跳入函數(shù)Shift F5結(jié)束調(diào)試。了解這幾個(gè)調(diào)試操作你就已經(jīng)能夠在 VS Code 中像使用專業(yè) IDE 一樣調(diào)試 C 程序了。5.5 Code Runner 一鍵運(yùn)行如果你不想折騰任務(wù)配置也可以安裝 Code Runner 擴(kuò)展。安裝完成后在編輯區(qū)右上角會(huì)出現(xiàn)一個(gè)三角形的運(yùn)行按鈕點(diǎn)擊就能直接編譯并運(yùn)行當(dāng)前文件。也可以通過(guò)右鍵菜單選擇“Run Code”。默認(rèn)情況下Code Runner 對(duì) C 語(yǔ)言的執(zhí)行命令大致是cd $dir gcc $fileName -o $fileNameWithoutExt $dir$fileNameWithoutExt這段命令的意思就是進(jìn)入當(dāng)前目錄編譯源文件生成與源文件同名但不帶擴(kuò)展名的可執(zhí)行文件然后運(yùn)行它。Code Runner 使用起來(lái)確實(shí)方便但它只負(fù)責(zé)運(yùn)行不負(fù)責(zé)調(diào)試。對(duì)于剛?cè)腴T、只想快速驗(yàn)證結(jié)果的同學(xué)來(lái)說(shuō)Code Runner 很友好。后面學(xué)到指針、數(shù)組、函數(shù)調(diào)試時(shí)仍然需要掌握tasks.json和launch.json的方式。6. 常見(jiàn)問(wèn)題與排查思路6.1 gcc 不是內(nèi)部或外部命令這是最典型的新手報(bào)錯(cuò)問(wèn)題本質(zhì)是系統(tǒng)找不到編譯器。排查步驟打開(kāi)一個(gè)新的 CMD 或 PowerShell 窗口輸入gcc --version。如果提示找不到命令檢查環(huán)境變量中是否配置了D:\mingw64\bin。檢查D:\mingw64\bin路徑下是否存在gcc.exe。修改環(huán)境變量后關(guān)閉并重新打開(kāi)所有終端窗口。這個(gè)問(wèn)題容易出現(xiàn)在配置完環(huán)境變量后忘記重啟終端。環(huán)境變量的讀取是在終端啟動(dòng)時(shí)完成的已經(jīng)打開(kāi)的終端不會(huì)自動(dòng)更新。6.2 編譯時(shí)報(bào)錯(cuò) “無(wú)法打開(kāi)文件 stdio.h”報(bào)錯(cuò)信息通常類似fatal error: stdio.h: No such file or directory常見(jiàn)原因是編譯器沒(méi)有正確安裝或者 gcc 命令指向的是一個(gè)不完整的工具鏈。你需要確認(rèn)安裝的確實(shí)是 MinGW-w64而不是單純的編譯器二進(jìn)制文件。另外如果你之前安裝過(guò)其他版本環(huán)境變量中先匹配到了舊路徑也會(huì)出現(xiàn)這個(gè)問(wèn)題。建議重新解壓一份 MinGW-w64并把 PATH 中相關(guān)的舊條目刪除。6.3 程序輸出中文亂碼中文亂碼的根源是字符編碼不一致。VS Code 默認(rèn)源文件保存為 UTF-8而 Windows 控制臺(tái)默認(rèn)使用 GBK 解碼。大部分情況下程序輸出的 UTF-8 中文在 GBK 終端里就變成了亂碼。解決辦法主要有以下幾種方法一在 VS Code 終端中執(zhí)行chcp 65001把當(dāng)前終端代碼頁(yè)切換為 UTF-8。這種方法每次打開(kāi)新終端都要重新執(zhí)行一次比較麻煩但很直接。方法二在launch.json中把externalConsole設(shè)置為true這會(huì)導(dǎo)致程序在外部控制臺(tái)窗口運(yùn)行。外部控制臺(tái)能更好地兼容一部分中文顯示但不一定萬(wàn)能。方法三將源文件編碼改為 GBK。在 VS Code 右下角可以看到當(dāng)前文件編碼點(diǎn)擊后選擇“通過(guò)編碼保存”選擇GBK。這樣源文件中的中文與終端編碼一致輸出就不會(huì)亂碼。缺點(diǎn)是如果以后換到 macOS 或 Linux 上GBK 編碼的文件可能顯示不正常。方法四如果你的系統(tǒng)是 Windows 10/11可以在系統(tǒng)區(qū)域設(shè)置中勾選“使用 Unicode UTF-8 提供全球語(yǔ)言支持”。這個(gè)選項(xiàng)位于“區(qū)域” - “管理” - “更改系統(tǒng)區(qū)域設(shè)置”中。開(kāi)啟后需要重啟系統(tǒng)但這樣會(huì)導(dǎo)致以前 GBK 編碼的老程序可能出現(xiàn)其他亂碼需要權(quán)衡。大一階段建議優(yōu)先采用方法一或者習(xí)慣寫英文輸出信息最大程度降低編碼問(wèn)題帶來(lái)的干擾。6.4 F5 調(diào)試時(shí)報(bào)錯(cuò) “無(wú)法啟動(dòng)調(diào)試”常見(jiàn)原因有兩種第一種是preLaunchTask指定的任務(wù)名稱和tasks.json中的標(biāo)簽不一致。仔細(xì)檢查launch.json中的preLaunchTask是否和tasks.json中l(wèi)abel完全一致包括大小寫和空格。第二種是miDebuggerPath指定的 gdb 不存在。可以打開(kāi)終端輸入gdb --version如果沒(méi)有輸出說(shuō)明 MinGW 安裝包不完整或者環(huán)境變量沒(méi)有包含 bin 目錄。把miDebuggerPath改成 gdb.exe 的絕對(duì)路徑也是一個(gè)直接的解決方式。6.5 編譯成功但沒(méi)有生成 exe 文件如果在終端執(zhí)行g(shù)cc hello.c -o hello.exe后沒(méi)有看到文件先檢查終端當(dāng)前目錄是不是源文件所在目錄。使用命令dir在 Windows 上查看當(dāng)前目錄內(nèi)容。如果你在別的目錄下執(zhí)行編譯命令輸出的 exe 就會(huì)生成在執(zhí)行命令的目錄下而不是源文件目錄下。6.6 按 Ctrl Shift B 提示 “沒(méi)有要執(zhí)行的生成任務(wù)”這說(shuō)明還沒(méi)有配置過(guò)tasks.json。重新按照第 5.2 節(jié)的方法使用命令面板配置默認(rèn)生成任務(wù)。VS Code 會(huì)自動(dòng)創(chuàng)建.vscode/tasks.json之后快捷鍵才會(huì)生效。6.7 代碼提示和智能提示不生效檢查是否安裝了 C/C 擴(kuò)展是否已經(jīng)重新加載 VS Code。另一個(gè)常見(jiàn)原因是文件沒(méi)有被識(shí)別為 C 語(yǔ)言看 VS Code 右下角的語(yǔ)言模式是否為C。如果不是點(diǎn)擊語(yǔ)言模式手動(dòng)選擇 C。6.8 常見(jiàn)問(wèn)題匯總表問(wèn)題現(xiàn)象常見(jiàn)原因解決思路gcc 不是內(nèi)部或外部命令PATH 未配置或終端未重啟配置環(huán)境變量并重開(kāi)終端找不到 stdio.h工具鏈不完整或路徑?jīng)_突重裝 MinGW-w64 并清理 PATH中文輸出亂碼源文件編碼與終端編碼不一致切換終端代碼頁(yè)或調(diào)整文件編碼調(diào)試不可用缺少 gdb 或任務(wù)名不匹配檢查 miDebuggerPath 與 preLaunchTask沒(méi)有生成 exe終端目錄不對(duì)使用 cd 切換到源碼目錄再編譯沒(méi)有生成任務(wù)可選未創(chuàng)建 tasks.json通過(guò)命令面板配置默認(rèn)生成任務(wù)7. 最佳實(shí)踐與工程建議7.1 文件名與目錄命名規(guī)范在初學(xué)階段就要養(yǎng)成好的命名習(xí)慣。文件名、目錄名建議全部使用英文或拼音不要出現(xiàn)中文和空格。因?yàn)槟承┚幾g器工具鏈對(duì)中文路徑支持不夠穩(wěn)定空格會(huì)導(dǎo)致命令行參數(shù)解析出錯(cuò)。例如文件名不要叫第1題.c更不要放在C:\Users\張三\桌面\新建文件夾這種路徑下。推薦的做法是建立類似D:\C-Learning\week01\homework1.c的層級(jí)結(jié)構(gòu)一目了然。7.2 統(tǒng)一編碼與終端設(shè)置為了避免中文亂碼建議從第一天開(kāi)始就統(tǒng)一團(tuán)隊(duì)或自己電腦上的編碼習(xí)慣。推薦配置如下在 VS Code 的設(shè)置中搜索terminal.integrated.profiles.windows如果使用 PowerShell可以在設(shè)置中添加{ terminal.integrated.defaultProfile.windows: PowerShell, terminal.integrated.profiles.windows: { PowerShell: { path: powershell.exe, args: [ -NoExit, chcp 65001 ] } } }這里使用chcp 65001讓每個(gè)新終端啟動(dòng)時(shí)自動(dòng)把代碼頁(yè)切到 UTF-8。注意不同版本的 VS Code 配置項(xiàng)略有差異如果你修改后終端沒(méi)有變化也可以簡(jiǎn)單地在每次開(kāi)會(huì)話時(shí)手動(dòng)執(zhí)行一次chcp 65001。同時(shí)在系統(tǒng)層面建議開(kāi)啟“使用 Unicode UTF-8 提供全球語(yǔ)言支持”。當(dāng)然這個(gè)決定會(huì)影響系統(tǒng)中其他軟件的中文顯示需要謹(jǐn)慎評(píng)估。如果只是為了寫 C 語(yǔ)言作業(yè)手動(dòng)chcp更安全。7.3 理解編譯錯(cuò)誤而不是盲目復(fù)制答案很多同學(xué)遇到編譯錯(cuò)誤第一反應(yīng)是上網(wǎng)搜索報(bào)錯(cuò)信息然后復(fù)制別人的代碼。這樣做雖然能完成任務(wù)但對(duì)能力的提升幾乎沒(méi)有幫助。正確的做法是閱讀報(bào)錯(cuò)信息找到錯(cuò)誤所在文件與行號(hào)。回到代碼中對(duì)照行號(hào)確認(rèn)出錯(cuò)位置。根據(jù)錯(cuò)誤提示猜測(cè)原因例如缺少分號(hào)、括號(hào)不匹配、變量未聲明。修正后重新編譯觀察報(bào)錯(cuò)是否消失。編譯器是最嚴(yán)格的“老師”每一次報(bào)錯(cuò)都是一次學(xué)習(xí)機(jī)會(huì)。C 語(yǔ)言的語(yǔ)法細(xì)節(jié)很多通過(guò)反復(fù)修改積累起來(lái)的經(jīng)驗(yàn)遠(yuǎn)比看十篇教程更有價(jià)值。7.4 注釋與代碼風(fēng)格大一階段的作業(yè)代碼雖然簡(jiǎn)單但也要注意代碼風(fēng)格。常見(jiàn)建議包括使用統(tǒng)一的縮進(jìn)推薦 4 個(gè)空格。變量名要有含義例如studentCount比a更容易理解。關(guān)鍵邏輯前后添加注釋中文注釋確保編碼一致。每個(gè)函數(shù)只完成一件事不要在main中堆太多邏輯。輸出信息如果是中文注意終端編碼如果是英文可以避免很多亂碼問(wèn)題。代碼風(fēng)格會(huì)影響你以后閱讀自己代碼的效率。很多同學(xué)學(xué)期末翻開(kāi)自己前幾周的作業(yè)完全看不懂自己寫了什么大部分原因是當(dāng)初寫的時(shí)候就沒(méi)有注意注釋和命名。7.5 以調(diào)試器為學(xué)習(xí)工具VS Code 的調(diào)試功能不只是用來(lái)找 bug 的更是理解程序執(zhí)行過(guò)程的利器。學(xué)習(xí)指針、數(shù)組、函數(shù)調(diào)用時(shí)可以設(shè)置斷點(diǎn)一步一步觀察變量值變化。這種“親眼看到程序運(yùn)行過(guò)程”的體驗(yàn)比看任何書都直觀。例如學(xué)習(xí)循環(huán)時(shí)你可以在for循環(huán)體內(nèi)部加一個(gè)斷點(diǎn)按F5啟動(dòng)調(diào)試后每按一次F10都能看到循環(huán)變量的變化這會(huì)幫助你快速理解循環(huán)的執(zhí)行順序。7.6 善用編譯選項(xiàng)在學(xué)習(xí)階段可以了解一些常用的 gcc 編譯參數(shù)gcc -Wall -g program.c -o program.exe-Wall開(kāi)啟所有常見(jiàn)的警告信息編譯器會(huì)用警告提示你潛在的代碼問(wèn)題。-g生成調(diào)試信息這是調(diào)試的前提。-o指定輸出文件名。在日常練習(xí)中不要忽略警告信息。警告不一定是錯(cuò)誤但往往意味著你的代碼有不符合規(guī)范的地方。把代碼改到編譯“零錯(cuò)誤零警告”是一個(gè)很好的習(xí)慣。8. 總結(jié)與下一步學(xué)習(xí)方向到這里你已經(jīng)完成了在 VS Code 中編輯、編譯、運(yùn)行和調(diào)試 C 語(yǔ)言的完整環(huán)境搭建?；仡櫼幌挛覀冏隽艘韵聨准掳惭b了 MinGW-w64 編譯器并把它加入 PATH 環(huán)境變量。在 VS Code 中安裝了 C/C 擴(kuò)展插件。編寫并編譯運(yùn)行了第一個(gè) C 語(yǔ)言程序。配置了tasks.json和launch.json實(shí)現(xiàn)了快捷鍵編譯和 F5 調(diào)試。梳理了常見(jiàn)報(bào)錯(cuò)以及排查思路。了解了一些編碼、命名、代碼風(fēng)格上的最佳實(shí)踐?，F(xiàn)在你已經(jīng)有了一個(gè)可以正常工作的 C 語(yǔ)言開(kāi)發(fā)環(huán)境。接下來(lái)的學(xué)習(xí)重點(diǎn)應(yīng)該放在 C 語(yǔ)言本身變量與數(shù)據(jù)類型、運(yùn)算符、流程控制、函數(shù)、數(shù)組、指針、結(jié)構(gòu)體、文件操作等。在后續(xù)的學(xué)習(xí)中每遇到一個(gè)新的知識(shí)點(diǎn)都可以在 VS Code 里寫一個(gè)小程序去驗(yàn)證。如果編譯報(bào)錯(cuò)了先自己讀報(bào)錯(cuò)信息如果程序運(yùn)行結(jié)果和你預(yù)期不一致試著用斷點(diǎn)調(diào)試去看變量的值。慢慢地你會(huì)發(fā)現(xiàn)編程語(yǔ)言的學(xué)習(xí)并不只是背語(yǔ)法而是通過(guò)“寫代碼、編譯、運(yùn)行、調(diào)試”這個(gè)循環(huán)不斷加深理解。VS Code 只是一個(gè)工具你隨時(shí)可以根據(jù)自己的喜好換成其他編輯器或 IDE。但這套“配置編譯器、理解編譯命令、使用調(diào)試器”的思路在任何開(kāi)發(fā)環(huán)境中都是通用的。掌握這種方式之后以后學(xué)習(xí) Java、Python、Go 等語(yǔ)言也可以沿用類似的配置邏輯。如果這篇文章對(duì)你有幫助建議收藏備用等真正動(dòng)手配置時(shí)再照著操作一遍。配置過(guò)程中遇到的問(wèn)題也歡迎在評(píng)論區(qū)留言一起討論。寫代碼是一個(gè)需要反復(fù)練習(xí)的技能希望你從第一個(gè)Hello World開(kāi)始順利走進(jìn)編程世界。