VSCode編寫運行C、C++ 程式的方法

相關推薦：《vscode基礎教學》

## 0. 前言

本文針對初學者，每一步都比較詳細。閱讀本文能學習一些命令列、程式編譯和除錯，以及使用VS Code的知識。如果嫌本文說的麻煩，我給個精簡版的：裝gcc和c/c 擴展，打開文件夾，點開源代碼，F1，build and debug active file，完畢。

本文許多內容都可從VS Code官方文檔：

C programming with Visual Studio Code 以及各個擴展的文檔中獲得，並且他們還會進行更新（本文也進行過幾次重大更新），如果你想更深入了解，可以去看。本文也基本上是由多次嘗試得出來的，如果有錯誤可以指出。

最終效果：即時顯示編譯階段的錯誤、程式碼片段、補全、格式化、單一檔案的編譯與偵錯。

1. 環境的準備

VSC的官網、下載、安裝，我就不多說了。 VSC只是一個純文字

編輯器(editor)，不是IDE(整合開發環境)，不含編譯器(compiler)和許多其它功能，所以編譯器要自己裝好。

下載編譯器：

MinGW-w64 - for 32 and 64 bit Windows 往下稍微翻一下，選最新版本中的x86_64-posix-seh。最好不要用 Download Latest Version，這個是線上安裝包，可能因為國內的「網路環境」下載失敗。如果瀏覽器下載失敗就換迅雷下或連手機開的熱點下，還失敗，那就使用能存取Google的那種方法下。

「安裝」編譯器：下下來的是一個7z的壓縮套件。如果你不會解壓縮可以百度「壓縮包怎麼解壓縮」。解壓完了放到一個不容易被刪除的地方，層疊的可以去掉一些。看好bin資料夾的完整路徑，我圖裡的是C:\mingw64\bin，把它加到環境變數中的PATH裡。如果你不會這一步，看本文最後面的「B. 如何加入環境變數」（可以在本頁用Ctrl F搜尋）

Debian系Linux用

sudo apt update; sudo apt install build-essential即可。

順序不重要；路徑可以不一樣，反正保證gcc.exe在那個資料夾裡就行

##驗證

按Win R，執行cmd（不要跳這一步），輸入gcc，應該會提示no input files

而不是「不是內部命令或外部命令」或「無法將"gcc" 項識別為cmdlet、函數、腳本檔案或可運行程式的名稱」。如果是“不是內部指令或外部指令”，表示gcc在的資料夾沒有在環境變數的Path中，要加進去才行。如果加了還是這樣，重啟。如果重啟了還不行，那就是你自己進行的操作有問題。

輸gcc -v可以顯示出gcc的版本。如果顯示出來的版本與你剛下的不同/更老

，表示Path裡原本有舊版的編譯器，可能是安裝其它IDE時裝上的。則需要去掉Path裡原來的那一個gcc的路徑。

這兩項驗證一定要符合，否則必須修改環境變數。小心別錯刪

了。 ###

現在不用管clang，必定出錯。 clang的教學移到本文後面去了

#輸入gcc -v的最後一行輸出。版本要跟你自己下的對應，例如64位元要有x86_64和seh

#安裝擴充功能(extension)

• C/C ：又稱為cpptools，提供Debug和Format功能
• Code Runner：右鍵即可編譯運行單文件，很方便；但無法Debug

其他可選擴充：

• Bracket Pair Colorizer 2：彩虹花括號
• One Dark Pro：大概是VS Code安裝量最高的主題

不建議/不需要裝的擴充：

• GBKtoUTF8：把GBK編碼的文檔轉換成UTF8編碼的。此擴充很久沒有更新了，可能有嚴重的bug
• C Intellisense：用的是gtags，本文第一個版本的選擇。效果非常非常一般
• Include Autocomplete：提供頭檔名字的補全，現在cpptools和vscode-clangd都已經自備這個功能了，所以不用裝
• C/C Snippets：Snippets即重用程式碼區塊，效果自己百度；這個擴充安裝量雖高，不過個人感覺用處實在不大，cpptools和clangd也自帶一些；你也可以選擇其他的Snippets擴充甚至自己定義

#補充知識

• 編譯器是把原始碼變成執行檔的，編輯器是你打字的軟體。記事本就是一個編輯器，VSC也是編輯器。 編輯器是無法編譯執行程式的，因為那是編譯器的工作
• MinGW是gcc在Windows下的移植，gcc是世界上最受歡迎的C/C 編譯器組合。但gcc這個名字也指編譯C語言的那個程序，g 是C 編譯器。即gcc程式和g 程式包含在gcc套件以及MinGW裡，只說gcc時要根據語境自己區分
• 其實MinGW和MinGW-w64只是名字像，它們是兩個不同的項目。為了方便，本文的MinGW指的其實都是MinGW-w64。 MinGW本身已經很久沒有更新了，不使用它哎呀，原來MinGW是活著的，但它只能產生32位元程式
• 擴充是extension，外掛程式是plugin， VSC用的是前者這種稱呼。大部分文章都是混用兩者的，不嚴謹但是能理解就行，要學會抓主要矛盾。當然本文用的都是正確的
• 可選閱讀：[科普][FAQ]MinGW vs MinGW-W64及其它

##2. 配置幾個.json檔案

建立一個你打算存放程式碼的資料夾，稱作工作區資料夾；

路徑不能含有中文和引號，最好不要有空格，我用的是C:\VS-Code-C。 C和C 需要分別建立不同的資料夾，除非用虛擬工作區。不要選上一節要存放編譯器的資料夾，原始碼和編譯器要分開放。

開啟VSC，

選開啟資料夾；最好不要選“新增工作區資料夾”，這個就是虛擬工作區，我沒用過，不保證沒問題。點新建資料夾，名稱為.vscode。不在資源管理裡新建的原因是Windows的Explorer不允許建立的資料夾第一個字元是點（1903後才支援）。然後建立 launch.json，tasks.json，settings.json（不是setting.json） 放到.vscode資料夾下。效果圖：

一定要在.vscode裡，別變成平行的了

這幾個檔案的內容見下。複製以下程式碼出來後，知乎會自動在前面加上幾行保留所有權利的字，實際使用的時候肯定要刪了的。有些地方可選修改，自己對照著註解看吧。注意：如果是寫C ，tasks.json的一個地方必須要修改。

launch.json程式碼

externalConsole可依自己喜好修改；cwd可以是程式執行時的相對路徑，如有需要可以改為${ fileDirname}（感謝@xhx）。 lldb我沒用過就不多說了。 type和request不變色是正常現象。

// https://code.visualstudio.com/docs/cpp/launch-json-reference
{
    "version": "0.2.0",
    "configurations": [{
        "name": "(gdb) Launch", // 配置名称，将会在启动配置的下拉菜单中显示
        "type": "cppdbg", // 配置类型，cppdbg对应cpptools提供的调试功能；可以认为此处只能是cppdbg
        "request": "launch", // 请求配置类型，可以为launch（启动）或attach（附加）
        "program": "${fileDirname}/${fileBasenameNoExtension}.exe", // 将要进行调试的程序的路径
        "args": [], // 程序调试时传递给程序的命令行参数，一般设为空即可
        "stopAtEntry": false, // 设为true时程序将暂停在程序入口处，相当于在main上打断点
        "cwd": "${workspaceFolder}", // 调试程序时的工作目录，此为工作区文件夹；改成${fileDirname}可变为文件所在目录
        "environment": [], // 环境变量
        "externalConsole": true, // 使用单独的cmd窗口，与其它IDE一致；为false时使用内置终端
        "internalConsoleOptions": "neverOpen", // 如果不设为neverOpen，调试时会跳到“调试控制台”选项卡，你应该不需要对gdb手动输命令吧？
        "MIMode": "gdb", // 指定连接的调试器，可以为gdb或lldb。但我没试过lldb
        "miDebuggerPath": "gdb.exe", // 调试器路径，Windows下后缀不能省略，Linux下则不要
        "setupCommands": [
            { // 模板自带，好像可以更好地显示STL容器的内容，具体作用自行Google
                "description": "Enable pretty-printing for gdb",
                "text": "-enable-pretty-printing",
                "ignoreFailures": false
            }
        ],
        "preLaunchTask": "Compile" // 调试会话开始前执行的任务，一般为编译程序。与tasks.json的label相对应
    }]
}

原本2018年10月後把externalConsole設為false可以使用內建終端，但2019年10月cpptools 0.26.1引進了一個bug，導致Win下用內建終端無法輸入中文，到現在0.29 .0仍沒有解決。我已經open了https://github.com/microsoft/MIEngine/pull/1025

#來fix，但一個月過去了他們並沒有review，負評。
• tasks.json程式碼
• 如果是寫C
，編譯器需改成g ；如果不想要額外警告，把-Wall那一條刪去；-std根據自己需要修改，但c 17好像有問題，最好至多用c 14；Linux下不需要加-fexec-charset。反正這些我都加了註釋，還看不懂，百度gcc使用教學。
• reveal控制編譯時是否跳到終端面板。可依自己喜好修改；即使設為never，也只是不自動跳轉，手動點進去還是可以看到訊息。

• // https://code.visualstudio.com/docs/editor/tasks
  {
      "version": "2.0.0",
      "tasks": [{
          "label": "Compile", // 任务名称，与launch.json的preLaunchTask相对应
          "command": "gcc",   // 要使用的编译器，C++用g++
          "args": [
              "${file}",
              "-o",    // 指定输出文件名，不加该参数则默认输出a.exe，Linux下默认a.out
              "${fileDirname}/${fileBasenameNoExtension}.exe",
              "-g",    // 生成和调试有关的信息
              "-m64", // 不知为何有时会生成16位应用而无法运行，加上此条可强制生成64位的
              "-Wall", // 开启额外警告
              "-static-libgcc",     // 静态链接libgcc，一般都会加上
              "-fexec-charset=GBK", // 生成的程序使用GBK编码，不加这条会导致Win下输出中文乱码；繁体系统改成BIG5
              // "-std=c11", // 要用的语言标准，根据自己的需要修改。c++可用c++14
          ], // 编译的命令，其实相当于VSC帮你在终端中输了这些东西
          "type": "process", // process是把预定义变量和转义解析后直接全部传给command；shell相当于先打开shell再输入命令，所以args还会经过shell再解析一遍
          "group": {
              "kind": "build",
              "isDefault": true // 不为true时ctrl shift B就要手动选择了
          },
          "presentation": {
              "echo": true,
              "reveal": "always", // 执行任务时是否跳转到终端面板，可以为always，silent，never。具体参见VSC的文档
              "focus": false,     // 设为true后可以使执行task时焦点聚集在终端，但对编译C/C++来说，设为true没有意义
              "panel": "shared"   // 不同的文件的编译信息共享一个终端面板
          },
          "problemMatcher":"$gcc" // 捕捉编译时终端里的报错信息到问题面板中，修改代码后需要重新编译才会再次触发
          // 本来有Lint，再开problemMatcher就有双重报错，但MinGW的Lint效果实在太差了；用Clang可以注释掉
      }]
  }

settings.json程式碼
• 把這個檔案裡的東西放到「使用者設定」裡可以覆蓋全域設置，否則只在目前工作區才有效。這兩點各有自己的優勢。
• Code Runner的命令列和某些選項可以根據自己的需求在此處修改，想自訂或想知道是什麼意思還是請參閱此擴充功能的文件和百度gcc使用教學課程。如果終端用的是cmd（

Win7

預設）需要改用註解掉的，或是把

terminal.integrated.shell.windows

改為PowerShell；Win10預設就是PS就不用改。 感謝

@Wellin Boss###提到的snippetSuggestions；不過用top有時還是有點問題的，所以改成可選。 ###

{
    "files.defaultLanguage": "c", // ctrl+N新建文件后默认的语言
    "editor.formatOnType": true,  // 输入分号(C/C++的语句结束标识)后自动格式化当前这一行的代码
    "editor.suggest.snippetsPreventQuickSuggestions": false, // clangd的snippets有很多的跳转点，不用这个就必须手动触发Intellisense了
    "editor.acceptSuggestionOnEnter": "off", // 我个人的习惯，按回车时一定是真正的换行，只有tab才会接受Intellisense
    // "editor.snippetSuggestions": "top", // （可选）snippets显示在补全列表顶端，默认是inline

    "code-runner.runInTerminal": true, // 设置成false会在“输出”中输出，无法输入
    "code-runner.executorMap": {
        "c": "gcc '$fileName' -o '$fileNameWithoutExt.exe' -Wall -O2 -m64 -lm -static-libgcc -std=c11 -fexec-charset=GBK && &'./$fileNameWithoutExt.exe'",
        "cpp": "g++ '$fileName' -o '$fileNameWithoutExt.exe' -Wall -O2 -m64 -static-libgcc -std=c++14 -fexec-charset=GBK && &'./$fileNameWithoutExt.exe'"
        // "c": "gcc $fileName -o $fileNameWithoutExt.exe -Wall -O2 -m64 -lm -static-libgcc -std=c11 -fexec-charset=GBK && $dir$fileNameWithoutExt.exe",
        // "cpp": "g++ $fileName -o $fileNameWithoutExt.exe -Wall -O2 -m64 -static-libgcc -std=c++14 -fexec-charset=GBK && $dir$fileNameWithoutExt.exe"
    }, // 右键run code时运行的命令；未注释的仅适用于PowerShell（Win10默认）和pwsh，文件名中有空格也可以编译运行；注释掉的适用于cmd（win7默认）、PS和bash，但文件名中有空格时无法运行
    "code-runner.saveFileBeforeRun": true, // run code前保存
    "code-runner.preserveFocus": true,     // 若为false，run code后光标会聚焦到终端上。如果需要频繁输入数据可设为false
    "code-runner.clearPreviousOutput": false, // 每次run code前清空属于code runner的终端消息，默认false
    "code-runner.ignoreSelection": true,   // 默认为false，效果是鼠标选中一块代码后可以单独执行，但C是编译型语言，不适合这样用
    "code-runner.fileDirectoryAsCwd": true, // 将code runner终端的工作目录切换到文件目录再运行，对依赖cwd的程序产生影响；如果为false，executorMap要加cd $dir

    "C_Cpp.clang_format_sortIncludes": true, // 格式化时调整include的顺序（按字母排序）
}

###c_cpp_properties.json######如果你確定不需要使用別人的庫，則現在的版本（0.18.0之後）###不需要建立這個檔案###了，cpptools會自動使用預設的設定。所以本文也不再包含此文件的配置。 ######如果你自己寫了頭檔又不在workspaceFolder下，或是使用別人的函式庫，就需要手動建立這個檔案放到###.vscode###下了。範本可以參考：###Microsoft/vscode-cpptools###。 ######一些曾經的經驗：#########庫的路徑要加到includePath和browse裡######如果需要遞歸包含，末尾加上###/**# ##。 ######這個json不允許有註釋，其實按照json標準本來就不能有######compilerPath好像必要是MinGW的完整路徑，精確到gcc.exe，否則會提示找不到頭檔； Linux下是/usr/bin/gcc；但我很久沒有測試過了######Windows下的目錄分隔符號為反斜杠，原本應使用兩個反斜杠來轉義，但直接用斜槓這裡也接受######除了配置這個文件，還需要進行別的操作。一部分可以參考下文的「多檔案編譯」#########補充知識######json是一種資料交換格式，大部分是JavaScript的子集> ;現在變成完全子集了。這裡就是用作###配置###檔。 VSC和各個擴充功能會讀取json中的條目，來決定某些功能和行為。 ###

這麼多條目哪裡來的呢？這其實跟API差不多。擴充開發者會把允許修改的選項「告訴」VSC，各個擴充的安裝頁面都有寫。身為使用者，輸入的時候VSC會提示你哪些是可用的，所以其實很容易寫。

為什麼要往json裡寫這麼多的東西？因為VSC本身並沒有對C語言特別優待，對其他許多語言也一樣。而且最關鍵的編譯指令和VSC是沒有關係的，這就是上面提到的編輯器和編譯器的事。 VSC不負責、無法、不能編譯C語言。

以$開頭的是VSC預先定義的變量，請參考：Variables Reference。例如$file在實際運行時會替換成目前開啟的檔名。

3. 寫程式碼，編譯，調試

新建檔案後就可以寫程式碼了，c語言原始碼後綴是.c，c 是.cpp或.C或.cxx（這也要我教嗎…）。程式碼檔案在儲存工作區內都可以，可以自己建立資料夾，不必放到.vscode資料夾裡，但路徑裡(包括檔案名稱)不要含有中文和引號 ，最好不要有空格。主要是許多符號是有效的shell語法，不然試試Linux下用rm刪除一個叫做-rf的檔案？沒查過絕對寫不出來。

按Alt Shift F（或用右鍵選單）可以格式化程式碼，修改格式化方式如大括號是否換行可看：Format Curly Braces on Same Line in C VSCode#。出現Intellisense的時候按tab可以補全代碼。打出snippets時會出現多個跳躍點，按tab可以跳到下一個去。

停止輸入一小段時間（一秒）後就會有Lint，擴充會給一些建議性的warning（例如宣告了變數但不使用），自己清楚就行。如果覺得不爽，也有方法不讓它提示，例如去掉-Wall就會少一點。如果還想去掉更多的警告，我提示一下：-Wno-...。找好參數後可以用#pragma GCC diagnostic ignored或是加到各種Flags裡。總之自己研究。不過cpptools的Lint不支援設定Flags，有點坑，Follow：Error and Warning Flags?  · Issue #2814 · microsoft/vscode-cpptools

接下來說說運行的事。首先，編譯是從原始碼產生可執行檔的過程。而調試其實是一種特殊的運行，是能控製程式運行，方便之後修改的手段。這是兩個不同的階段，可能出現編譯通過但偵錯失敗，也可能直接編譯就失敗，還有可能編譯還沒開始就失敗了。如果你只說“運行失敗”，別人是看不出是哪個階段出了問題的。如果確定某個階段通過了，那就不用管那個階段了，就能專注在解決別的階段的問題。

按Ctrl Shift B單純編譯，按F5為編譯加調試；本來ctrl F5為運行但不調試，但現在cpptools暫不支持，還是會調試。 Follow: Support "Run without debugging" · Issue #1201 · microsoft/vscode-cpptools

在寫程式初期，我強烈建議不要把f5當作編譯來使用，因為有的bug只會產生警告，不會阻止編譯，但這些東西越早期解決越好。編譯資訊會在底下的「終端」面板裡，如果程式碼有錯誤，點進去可以看編譯器報的資訊；不過因為有Lint了，平常的錯誤可以馬上被發現修改，寫程式就輕鬆很多。

加斷點在列號前面點一下就行，右鍵可以加條件斷點。如果想從一開始就停下來，可以加在main函數那裡，或是launch.json中有個設定。開始調試後，按f11可以一步一步進行，箭頭所指的那行程式碼就是下一步要運行的程式碼；f5是一直運行到下一個斷點，右鍵某行程式碼可以選擇一直運行到指定的那一行。

左邊有個偵錯欄，可以看到變數的值，自動欄沒有的可以手動新增：在程式碼裡選取要監視的表達式，點右鍵有選項可以直接加入到Watch裡，複雜的才需要手打。把滑鼠放到變數上可以看到變數的值，但是只能辨識簡單的表達式。棧幀對於觀察遞歸很有用。堆疊溢位和段錯誤時還可以抓取“異常”，自動跳到出錯的行。

特別的，對於數組：C語言的數組經過函數傳遞以後會退化為指針，直接添加表達式就只能看到第一個元素。此時可以強制轉換成指向固定大小的陣列指標再解引：例如int arr[10]傳進函數裡後就變成了int* arr，在Watch裡加上*(int(*)[10])arr，這樣就能看到完整的陣列了。但長度必須是寫死的，自己小心越界。或者簡單的程式用全域變數數組就能一直看到了。另一種只對gdb且是非void*有效的寫法：*arr@10。

快速鍵：vscode: Visual Studio Code 常用快捷鍵 - 志文工作室。英文文檔當然有快捷鍵的說明，還有Cheet Sheet可以看，而且英文文檔會更新。這個單獨列出來僅給初學者。

如果遇到錯誤，先看底下的「某些可能出現的錯誤」以及看評論區。

Code Runner

如果你不需要偵錯，可以直接右鍵選取run code，或是點選右上角的播放按鈕。如果在終端機裡運行，可以輸入數據，但是少了顯示時間的功能；在「輸出」中則上面兩項相反。

在終端機中按Ctrl C可以終止程式運行，下一次運行前必須保證目前程式已經終止了（對於task也是一樣的）。如果你想要複製，選取內容後直接按一下右鍵就可以了；貼上則是在未選取時按右鍵；這個動作僅限於Win10，ctrl c也可以複製但可能一不小心就把程式終止了。

用它還可以在非工作區內編譯運行程序，不過預設用的是gcc，除非把executorMap放到全域設定裡。按照我的配置，task和Code Runner還有一點不同：working directory。前者是你打開的資料夾，後者是檔案所在的資料夾。當然它們也都可以自己修改。

其實Code Runner只是代替你手動輸指令，功能並不強，算是適用場景不同吧。不要以為run code跑個Hello World很簡單，Code Runner就很強、前面那麼多設定都是垃圾了。

另外，樓下的答主韓駿就是此擴展作者，有事統統找他（滑稽）。

多檔編譯

如果你想進行少量的多檔編譯，C語言直接用gcc 原始檔1.c 原始檔2.c 頭檔1.h這樣就好，C 用g 。預設產生a.exe，加-o可指定輸出檔名，其餘選項百度gcc使用教學。如果需要多次編譯可以寫一個批次。

如果你想進行大量的多檔案編譯，請學習如何寫makefile或使用cmake。然後把tasks的指令改成呼叫make（或mingw32-make）等。

如果你想使用別人的函式庫，例如ffmpeg，可能需要在指令中指定-I、-l（小寫的L）、- L。具體參數閱讀那個庫的文檔。也可能需要把路徑加入c_cpp_properties.json裡來設定Intellisense。

這些情況下可以考慮單獨建立一個工作區，不要和單一檔案編譯的共用。其實不新建工程(Project)、只是單一檔案就能調試，是不利於以後使用和理解大型IDE的。不過初學也不用掌握那麼多，不要覺得建工程很麻煩、不建工程就能編譯很強就是了。

總之這些和VSC無關，用其它IDE或手動編譯也會遇到差不多的問題，也有點複雜。本文就不多討論這些了，自行解決。

儲存資料夾

以後寫程式碼必須打開之前那個建立好的資料夾才能寫，否則所有的Intellisense都沒有，只有Code Runner能用。 （主要是需要那四個json，新建其它資料夾需把那幾個json複製過去就也能用）

可以創建一個快捷方式（右鍵新建），把工作區路徑作為參數傳給VSC主程序，記得打雙引號；還可以加個圖示。 1.18有了真正的虛擬工作區，可以一個視窗包含多個不在一起的資料夾，「檔案」選單裡也有「保存工作區」這個功能，但是我都沒試過，不保證沒問題。

清理臨時檔案

按照這樣配置，長期編譯程式碼下來一定有一大堆的exe，也可能分散在不同的資料夾裡。

可以考虑修改一下json文件，把生成文件的目录指定到一个专门放exe的文件夹里；如果不会，百度gcc使用教程以及看我的json里的注释。或者资源管理器右上角搜索*.exe然后手动删除。

也可也写个bat，放到工作区里，要用的时候右键Run Code：

del %~dp0*.exe /q /s
del %~dp0tempCodeRunnerFile.c /q /s
del %~dp0a.out /q /s
del %~dp0*.o /q /s

其中%~dp0会被替换成该批处理所在目录，这是为了防止有同学选错工作目录，误删根目录下的文件；code runner的设置我也调整成了先切换到文件目录，双保险。

添加纯英文输入法

Windows 10，默认输入法只有一个微软拼音，按一次shift就能进行中英转换；为了保持兼容，按ctrl加空格也能进行中英转换，但这个快捷键正是强制触发Intellisense的快捷键。

所以，我强烈建议手动添加“英语”语言输入法，正常代码时切换到纯英文输入法（win+空格），在需要频繁中文注释或者在字符串里写中文时才用中文输入法的英文模式。

这样也可以解决某些游戏需要用到shift键但同样快捷键冲突的问题。具体操作可以自己百度，也可以看我写的这篇有点复杂的文章：Windows 切换显示语言与添加纯英文输入法。

某些可能出现的错误

为了阅读的连贯性，这一部分移到了“A. 一些其它可能出现的错误”。遇到问题优先查看那里是否已经提了。

4. 其他设置

我的一些其他的设置，用在全局settings.json里，根据自己的情况调整，不需要全部照着我的写。写完一个以后要打逗号；最外面的那个大括号我没加，就别弄丢了。

现在的VSC用的是可视化的设置界面，其实原本是手动编辑且出现两列设置的。点击右上角那个花括号就能手动编辑。

作者：谭九鼎
链接：https://www.zhihu.com/question/30315894/answer/154979413
来源：知乎
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

"editor.fontFamily": "等距更纱黑体 SC", // 控制编辑器字体
"editor.fontSize": 16, // 同上
"editor.fontLigatures": true, // 连体字，效果不太好形容，见 https://typeof.net/Iosevka 最后一部分
"editor.minimap.enabled": false, // 我个人不用minimap，就是右边那个东西
"editor.dragAndDrop": false, // 选中文字后，可以拖动它们调整位置。我是不需要
"editor.cursorSmoothCaretAnimation": true, // 移动光标时变得平滑
"editor.smoothScrolling": true, // 滚动平滑，不过效果很微弱
 
"files.trimTrailingWhitespace": true, // 保存时，删除每一行末尾的空格
"files.insertFinalNewline": true, // 保存后文件最末尾加一整行空行，Linux下的习惯
"files.autoGuessEncoding": false, // 启用后，会在打开文件时尝试猜测字符集编码。我关闭的理由见6，默认也是禁用的

"workbench.colorTheme": "One Dark Pro", // 主题
"workbench.colorCustomizations": {
      "activityBar.foreground": "#39C5BB" // 自定义颜色；想定义其它位置参见官方文档
},
"workbench.settings.useSplitJSON": true, // 恢复手动编辑时的两列设置
"window.zoomLevel": 0.2, // 整体放大

"git.enabled": false, // 如果你不用git，可以考虑关闭它
"git.ignoreMissingGitWarning": true, // 同上

"[c]": {
    // "files.encoding": "gbk" // 这样的格式可以对指定后缀的文件应用设置，如果你实在想用gbk，就这样设置吧。cpp同理。
},

更纱黑体是楼下B神做的字体，特点是标点好看（误）：be5invis/Sarasa-Gothic

Consolas虽然是Windows自带字体中还算行的，但它只有英文字体；微软雅黑虽然是非衬线字体，但它不是等距的，这一点非常不适合编程，等线也不等距；中易宋体……告辞。不下新的字体，其他两大系统我不清楚，Windows下简直没有编程可用的字体。Consolas加雅黑嘛，也还行吧，不过能用更好的干嘛不用呢。

6. 关于中文和乱码

VS Code输出中文会出现乱码，很多人都遇到过。这是因为源代码默认是UTF-8编码，cmd/PowerShell是GBK编码。直接编译，会把“你好”输出成“浣犲ソ”。Linux就没有这个问题。

一种解决方法是用gcc，编译时用-fexec-charset=GBK这个参数（目前的配置是有的），生成的程序就是GBK编码的，源文件仍是UTF8。而clang的execution-charset supports only UTF-8，所以用clang就无解。

另一种方法是用宽字符输出，有点复杂，见：C语言与中文的一些测试 (Win, UTF8源码) 。此文也提到了chcp 65001的事。

直接修改非Unicode程序的语言为UTF8(beta)会导致所有用GBK的程序乱码，这是不可接受的。

当然，如果你不打算坚持用UTF8作为源代码的编码，那直接用GBK编码也行。

如果是打开已有的以GBK编码的文件，VS Code默认会以UTF-8编码打开（除非你设置了猜测编码），这样编辑器内的中文就会乱码，此时要点右下角的GBK，选“通过编码重新打开”，选UTF-8即可。那为什么不打开自动猜测编码呢？可以参见我的这个回答：VS Code 中文注释显示乱码怎么办？。如果你不担心，那就开吧。

如果把代码文件发给其他用Windows的人，最好转成GBK，否则别人用记事本打开有可能会乱码（1803后的记事本改善了一些，联通已经不会乱码了）。

对于调试，无论怎么做，gdb都无法调试路径中存在中文的程序。这个貌似是gdb的bug，但是优先级极低：[gdb] cannot not open source file with Chinese/Unicode characters in path when debugging · Issue #602 · microsoft/vscode-cpptools

总之，对于Windows，这些问题没什么好办法，因为本文用的这一套就是从Linux搬过来的。用Linux应该就没有这些问题了。

7. 找不到頭檔的錯誤

• #gcc不在Path裡。回去看上面的驗證那一步
• 手動配置了c_cpp_properties.json且包含的路徑不正確。如果沒有創建此文件就不用管
• 重啟試試

如果你保證這幾點都符合要求，那我也沒什麼好辦法……要不就換其它答主的教程吧。注意這句話是終極Fallback，如果你確信你沒有操作錯誤，那就不用問我了，我是無法解決的。

另一種找不到頭檔的錯誤：

#這種情況是因為clang的預設target為msvc，需要加--target=x86_64-w64-mingw這個參數才行。

這個預設target是寫死在原始碼裡的，我找了一圈沒找到正常修改辦法。下載clang的原始碼，自己改掉，再編譯clang本身，也許可以解決。或是裝Windows SDK而不使用mingw，這樣就符合預設target了。

當然這時候最簡單的方法就是用gcc編譯。

12. 在Win下使用clang

其實這部分本來是本文的主打部分的，但是確實會引入太多概念，而且效果也不是那麼好（因為沒有libc ），現在全都放在這裡變成可選內容。理論上在WSL裡用更好，又但也許這樣會從一個坑跳到另一個坑，我沒試過。本部分僅留作踩坑經驗。

• Q：為什麼要裝Clang？
  A：錯誤提示更友善。以及：Clang 比 GCC 好在哪裡？
• Q：Clang怎麼讀？
  A：正確答案是/?kl??/，即c發"可"的音；不過實際還是以雙方都理解為基礎，例如平常把SQL說成circle也是能理解的。
• Q：為什麼既要裝Clang又要裝MinGW？
  A：因為Win下的Clang沒有libc 。你也可以選擇裝VS用Windows SDK，就不需要MinGW了，這個比較官方一些，但體積較大。
• Q：MSVC integration install failed / unable to find a Visual Studio installation...
  A：就是上一條的原因，Clang預設用的是MSVC的後端。但這部分用的是MinGW，所以就不用管這個提示。要不就裝Windows SDK

環境

• #LLVM Download Page：在此頁面下載Clang。選Pre-Built Binaries 中的Windows (64-bit)，不需要下.sig檔案
• vscode-clangd：提供Intellisense和Lint功能；倉庫及用法見：clangd/clangd
• C/C Clang Command Adapter：本文曾用過，vscode-clangd出現問題時可以考慮換成這個試試；配置有一些不同，需要改clang.cflags；如果沒出問題就別裝了
• Clang-Format：只有想自訂程式碼風格時才裝，例如大括號是否換行。需要另外學習如何使用
• CodeLLDB：lldb的vscode擴展，需要Python環境；我沒用過

##配置

編譯指令加一句
• --target=x86_64-w64-mingw。 clang的預設target為msvc，不加就會找不到頭檔
• C_Cpp.errorSquiggles、C_Cpp.autocomplete、C_Cpp.suggestSnippets#都關掉，否則會跟clangd報的重複

compile_flags.txt

其實就是設定那些編譯選項，基本上用-Wall和--target=x86_64-w64-mingw就行。 clangd只會使用離要評估的檔案最近的一個compile_flags.txt。因為需要保證有--target，最好建立一個放到工作區磁碟的根目錄用作fallback。

但比較坑的是，C和C 都會使用.h作為頭文件，如果不加任何std，.c和.cpp能正確lint，但是.h會使用C的模式。對於fallback來說感覺沒什麼好方法。還是那句話，要不就裝Windows SDK。

13. 我寫程式碼的體驗

體積上，本體 編譯器 擴展，如果只是用來寫C，硬碟佔用並不算小，上1G了。記憶體佔用還是比較少的（0.5g左右）；曾經出過吃大量記憶體的bug，當然現在早就修好了。

VSC的第一個優勢也許是好看？雖然不是專門為C/C 設計的，但它應該是現在最現代化的純文字編輯器了。而且光Lint這點就比wintc、cfree、dev c 強了許多了，更別提dev c 自己的Debug功能就有bug。

其它IDE，CodeBlocks還活著，雖然歷史包袱非常明顯。 Clion介面美觀，功能也挺強，不過只有英文，剛上手用起來可能有點困難；學生可以免費申請key，否則收費。如果想用Windows SDK，下個Visual Studio (Installer)，Community版勾上C 桌面開發就是，這樣就符合Clang的預設Target了，但我覺得不如直接用VS。其它答主對一些C的IDE的評價可以看這個回答：毫無編程基礎的小白準備學習C語言，用VC6還是VS2015？ 。

我還有一點想對學生黨說：能自己百度到這篇文章，努力去看懂、動手配置，已經比貼吧無數伸手黨和等著老師在qq群裡髮IDE的人強了很多了。如果有能力，還是建議你們讀讀VSC的文檔：Documentation for Visual Studio Code，並不復雜，體驗一下英文的實際應用也不錯哦。

A. 一些其它可能出現的錯誤

• 如果你只寫了個hello world，不加任何斷點，按f5以後黑框一閃而過/閃退是正常現象。想讓程式暫停運行可以在最後加上一個或兩個getchar();，不明白為什麼有時要用兩個？去問你們C語言老師；或用system("pause")，或加斷點，或launch.json裡用內建終端(externalConsole false)。如果你硬要用外接終端且要什麼都不做，就想運行後暫停在那裡，那麼VSC辦不到，至少我的配置辦不到，我也不想研究，因為我用內建終端。
• preLaunchTask「Compile」已終止，退出程式碼為1：編譯有error並且你用的是F5運行的就會有這個提示；如果你點仍然調試，就會調試上一次編譯成功的文件。其實所有的編譯失敗都會觸發這個錯誤，出錯的回傳值是1不是常識？所以只是告訴我出現了這個提示根本沒用，它的意思就是出錯了，沒有人能看出原因，原因在「終端」面板裡。如果Hello World能正常偵錯運行，但某個其它程式碼出現這個錯誤，很可能是你自己程式碼本身有錯誤。
• 終端將被任務重複使用，按任意鍵關閉：聽過「按任意鍵繼續」嗎？這句話就是這個意思。這句話比上面那個退出代碼為1還要沒用，它根本就不包含任何有效信息，無論成功還是出錯都會顯示它，它就是一個說明性的文字。
• 無法開啟...，找不到檔案(file:///build/glibc-OTsEL5/glibc-2.27/...)：我在Linux下遇到了這個問題，看起來應該是你試圖step in一個函式庫函數，但沒有原始碼。解決方法是下一個glibc放到指定位置。或參考這個：Disable "Unable to open file" during debug · Issue #811 · Microsoft/vscode-cpptools。
• undefined reference to xxx ... linker command failed：呼叫了未宣告的函數。可能是函數名稱打錯了，或是沒有include頭檔。總之是你自己的程式碼有錯誤。
• ld: cannot open output file ... permission denied：原始程式仍在運行（例如死循環），無法被覆蓋所以生成失敗。任務管理器結束那個進程即可。
• MinGW下，監視（Watch）視窗裡用strcmp，會導致gdb崩潰退出，原因不明。 linux下正常。
• 重新命名檔案後，原來已有的Lint還會在問題欄裡；修改了檔案後斷點可能會失效。以及還存在一些其他的像這樣的小bug，一般關掉VSC再開就行。
• 此配置無法使用Bash for Windows或WSL，因為bash中的反斜線會被辨識為換行。 cpptools現為launch.json提供了一個Bash on Windows Launch的snippets。現在又出了一個Remote WSL。但這些我都沒有試過如何使用。
• 如果你要進行調試，不要開優化。 gcc用-Og還可以保留一些調試信息，但clang用了以後就不能用gdb調試了。即使如此我還是在某一次寫程式碼的時候遇到了無法跳入函數的問題，而VS可以跳入。
• vscode-clangd第一次無法正確偵測到printf和scanf還有realloc，但程式碼中用過一次以後就好了。我也不知道為什麼。
• 此時不應有 &：終端改為用PowerShell或code runner的executorMap用我註解掉的那兩個指令。具體看上面settings.json的說明。
• crt0_c.c:(.text.startup 0x2e): undefined reference to `WinMain'：沒有main函數，或把main寫成了mian。
• 在Win下用clang mingw，#include 會報'float.h' file not found，改成g 後就好了。我覺得這應該是庫的bug，反正我是不知道怎麼解決。或別用C 17試試

B. 如何新增環境變數

圖形化的方式：右鍵“此電腦”，選屬性；或按win PauseBreak。選左邊的高級系統設置，高級，環境變數。選上面那幾個條目中的Path，編輯，新建。然後把含有目標exe的資料夾路徑填進去。例如gcc在C:\mingw\bin\gcc，就填C:\mingw\bin，Win大小寫不敏感。

命令列的方式：開啟cmd或PS，setx /m path "%path%;C:\mingw\bin\" 。此命令無需管理員權限，且不會隨著終端退出而退出（就是和上面圖形化的效果一樣）。

如果還不知道怎麼修改，可以自己百度或b站搜尋「環境變數」看影片。大多不是C的但是差別不大，小心別錯刪了就是。

---

有問題可以留言討論，不過最好詳細一點描述。 而且我再說一次，不要只告訴我「preLaunchTask已終止，代號為1」這句話。這句話沒用。

更多程式相關知識，請造訪：程式設計入門！ ！

以上是VSCode編寫運行C、C++ 程式的方法的詳細內容。更多資訊請關注PHP中文網其他相關文章！