【環境配置】Visual Studio Code 如何編寫運行 C、C++ 程序?

作者:譚九鼎
鏈接:https://www.zhihu.com/question/30315894/answer/154979413
來源:知乎
著作權歸作者所有。商業轉載請聯繫作者獲得授權,非商業轉載請註明出處。
 

0. 前言

本文面向初學者,每一步都比較詳細,但仍需一定基礎。閱讀本文能在一定程度上學習程序編譯的知識,以及使用VS Code的知識。本文確實涉及了較多的概念,如果你不是計算機相關專業,看其它答主的可能會容易一些,也不用學那些額外的知識。本文與其它大部分文章最大的不同:儘量使用Clang。

本文許多內容都可從VS Code官方文檔:C++ programming with Visual Studio Code 以及各個擴展的文檔中獲得,並且他們還會進行更新(本文也進行過幾次重大更新),如果你想更深入瞭解,可以去看。本文也基本上是由多次嘗試得出來的,如果有錯誤可以指出。

我的環境:64位Windows 10。32位Win需要修改許多地方,看其它答主的比較好;Win7好像必須裝dotnet FW 4.5以上否則無法調試;Linux下也有一些不同,僅供參考。

最終效果:實時顯示編譯階段的錯誤、代碼片段、補全、格式化、單文件的編譯與調試;這幾個功能看起來和其它答主的差不多,但因爲用了Clang,效果是有一些區別的。

1. 環境的準備

VSC的官網、下載、安裝,我就不多說了。VSC只是一個純文本編輯器(editor),不是IDE(集成開發環境),不含編譯器(compiler)和許多其它功能,所以編譯器要自己裝好。

其實MinGW和MinGW-w64只是名字像,它們是兩個不同的項目。爲了方便,本文中的MinGW指的其實都是MinGW-w64。MinGW本身已經很久沒有更新了,故不推薦。下載以下兩個程序(都要):

  • LLVM Download Page 在此頁面下載Clang。選 Pre-Built Binaries 中的 Windows (64-bit),不需要下.sig文件
  • MinGW-w64 - for 32 and 64 bit Windows 在此頁面下載 MinGW-w64,往下稍微翻一下,選最新版本中的x86_64-posix-seh。最好不要用 Download Latest Version,這個是在線安裝包,可能因爲國內的“網絡環境”下載失敗。如果瀏覽器下載失敗就換迅雷下或者連手機開的熱點下,還失敗,那就使用能訪問Google的那種方法下

安裝Clang:添加環境變量時,選 Add LLVM to the system PATH for all users(即第二項,不過第三項也差不多);路徑我填的是 C:\LLVM,也可以保持默認或者自己改。

安裝MinGW-w64:下下來的是一個7z的壓縮包。如果你懂怎麼添加環境變量,解壓到想要的位置後直接把gcc.exe所在的bin文件夾加到Path裏即可。如果不懂,隨便解壓到一個地方,把東西全部複製或者直接剪切到Clang的文件夾裏去,它們會無衝突合併,然後就可以把它刪了,這樣做(如果下面的驗證通過)就可以不改環境變量:

懂怎麼添加Path就不用做這一步

驗證

運行cmd,輸clang或gcc,應該會提示 no input files 而不是“不是內部命令或外部命令”或者“無法將“clang”項識別爲 cmdlet、函數、腳本文件或可運行程序的名稱”,見下圖。如果是“不是內部命令或外部命令”,說明clang.exe在的文件夾(我圖裏的是 C:\LLVM\bin)沒有在環境變量中,要加到Path裏纔行。如果加了還是這樣,重啓。

clang -vgcc -v可以顯示出各自的版本。如果顯示出來的版本與你剛下的不同/更老,說明Path裏原本有老版本的編譯器,可能是安裝其它IDE時裝上的。則需要去掉Path裏原來的那一個gcc的路徑。

這兩項驗證一定要符合,clang和gcc都要有,否則必須修改環境變量,把它們加到Path裏去。如果你不知道怎麼修改環境變量可以自己百度或者b站搜“環境變量”看視頻。大多不是C的但是區別不大,小心別錯刪了就是。

輸入gcc -v的最後一行輸出。版本要和你自己下的對應,要有x86_64和seh

安裝擴展(extension)

必裝:

  • C/C++:又名 cpptools,提供Debug和Format功能
  • vscode-clangd:提供Intellisense和Lint功能;倉庫見:clangd/clangd
  • Code Runner:右鍵即可編譯運行單文件,很方便;但無法Dubug

其他可選擴展:

  • Bracket Pair Colorizer 2:彩虹花括號
  • One Dark Pro:大概是VS Code安裝量最高的主題
  • C/C++ Clang Command Adapter:是本文前一個版本選擇的擴展,vscode-clangd出現問題時可以考慮換成這個試試;配置有一些不同,需要改clang.cflags;如果沒出問題就別裝了
  • Clang-Format:只有想自定義代碼風格時才裝,比如大括號不換行。需要另外學習如何使用
  • CodeLLDB:lldb的vscode擴展,需要Python環境;我沒用過

不建議/不需要裝的擴展:

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

FAQ

  • Q: 爲什麼要裝Clang?
    A: 錯誤提示更友好。以及:Clang 比 GCC 好在哪裏?
  • Q: Clang怎麼讀?
    A: 正確答案是/ˈklæŋ/,即c發"可"的音;不過實際還是以雙方都理解爲基礎,比如平常把SQL說成circle也是能理解的
  • Q: 爲什麼既要裝Clang又要裝MinGW?
    A: Clang沒有stdio.h等頭文件。至於爲什麼沒有,我就不知道了;也許就是下一點的原因
  • Q: MSVC integration install failed / unable to find a Visual Studio installation...
    A: Win下的Clang默認用的是MSVC的後端。如果完全按照本文接下來的操作,不用管這個提示
  • 可選閱讀:[原創][科普]MinGW vs MinGW-W64及其它What is difference between sjlj vs dwarf vs seh?

2. 配置幾個.json文件

先創建一個你打算存放代碼的文件夾(稱作工作區),路徑不能含有中文和引號,最好不要有空格,在我的例子中是C:\VS-Code-C。C和C++需要分別建立不同的工作區,除非你已經掌握了一定程度的知識。

打開VSC,選打開文件夾,不要選“添加工作區文件夾”,因爲好像有奇怪的問題,我也沒試過。點新建文件夾,名稱爲.vscode。不在資源管理裏新建的原因是Windows的Explorer不允許創建的文件夾第一個字符是點(1903後才支持)。然後創建 launch.json,tasks.json,settings.json 放到.vscode文件夾下,效果圖:

特別提示:默認F5只能編譯調試C,如果你要調試C++,必需改tasks.json中的第一點;而且要修改compile_flags.txt。具體參見小節說明,其它的如果實在看不懂,保持默認就好。

複製以下代碼出來後,知乎會自動在前面加上幾行保留所有權利的字,實際使用的時候肯定要刪了的。

launch.json代碼

externalConsole可根據自己喜好修改;cwd可以是程序運行時的相對路徑,如有需要可以改爲${fileDirname}(感謝

xhx

)。lldb我沒用過就不多說了。type和request不變色是正常現象。

// https://github.com/Microsoft/vscode-cpptools/blob/master/launch.md
{
    "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, // 爲true時使用單獨的cmd窗口,與其它IDE一致;18年10月後設爲false可調用VSC內置終端
            "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相對應
        }
    ]
}

tasks.json代碼

如果是編寫C++,編譯器需改成clang++;如果想用MinGW就分別是gcc和g++,但注意把--target那條刪去。

如果不想要額外警告,把-Wall那一條刪去;-std根據自己需要修改。

reveal控制編譯時是否跳轉到終端面板。可根據自己喜好修改;即使設爲never,也只是不自動跳轉,手動點進去還是可以看到信息。我個人設爲never。

args的參數的作用我加了註釋,還看不懂,百度gcc使用教程。

// https://code.visualstudio.com/docs/editor/tasks
{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Compile", // 任務名稱,與launch.json的preLaunchTask相對應
            "command": "clang", // 要使用的編譯器,C++用clang++;如果編譯失敗,改成gcc或g++試試,還有問題那就是你自己的代碼有錯誤
            "args": [
                "${file}",
                "-o", // 指定輸出文件名,不加該參數則默認輸出a.exe,Linux下默認a.out
                "${fileDirname}/${fileBasenameNoExtension}.exe",
                "-g", // 生成和調試有關的信息
                "-Wall", // 開啓額外警告
                "-static-libgcc", // 靜態鏈接libgcc,一般都會加上
                "--target=x86_64-w64-mingw", // clang的默認target爲msvc,不加這一條就會找不到頭文件;用gcc或者Linux則掉這一條
                // "-std=c11", // C++最新標準爲c++17,或根據自己的需要進行修改
            ], // 編譯命令參數
            "type": "process", // process是vsc把預定義變量和轉義解析後直接全部傳給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" // 此選項可以捕捉編譯時終端裏的報錯信息;本文用的是clang,開了可能會出現雙重報錯信息;只用cpptools可以考慮啓用
        }
    ]
}

settings.json代碼

把這個文件裏的東西放到“用戶設置”裏可以覆蓋全局設置,否則只在當前工作區纔有效。這兩點各有自己的優勢。

Code Runner的命令行和某些選項可以根據自己的需要在此處修改,用法還是參見此擴展的文檔和百度gcc使用教程。如果終端用的是cmd(Win7默認)需要改用註釋掉的命令行,或者把terminal.integrated.shell.windows改爲PowerShell。

Linux下記得去掉--target那個參數。

感謝

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": "cd $dir && clang '$fileName' -o '$fileNameWithoutExt.exe' -Wall -g -O2 -static-libgcc --target=x86_64-w64-mingw -std=c11 && &'$dir$fileNameWithoutExt'",
        "cpp": "cd $dir && clang++ '$fileName' -o '$fileNameWithoutExt.exe' -Wall -g -O2 -static-libgcc --target=x86_64-w64-mingw -std=c++17 && &'$dir$fileNameWithoutExt'"
        // "c": "cd $dir && clang $fileName -o $fileNameWithoutExt.exe -Wall -g -O2 -static-libgcc --target=x86_64-w64-mingw -std=c11 && $dir$fileNameWithoutExt",
        // "cpp": "cd $dir && clang++ $fileName -o $fileNameWithoutExt.exe -Wall -g -O2 -static-libgcc --target=x86_64-w64-mingw -std=c++17 && $dir$fileNameWithoutExt"
    }, // 控制Code Runner命令;未註釋的僅適用於PowerShell(Win10默認),文件名中有空格也可以編譯運行;註釋掉的適用於cmd(win7默認),也適用於PS,文件名中有空格時無法運行
    "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是編譯型語言,不適合這樣用

    "C_Cpp.clang_format_sortIncludes": true, // 格式化時調整include的順序(按字母排序)
    "C_Cpp.errorSquiggles": "Disabled", // 因爲有clang的lint,所以關掉;如果你看的是別的答主用的不是vscode-clangd,就不要加這個了
    "C_Cpp.autocomplete": "Disabled", // 同上;這幾條也可以考慮放到全局裏,否則很多錯誤會報兩遍,cpptools一遍clangd一遍
    "C_Cpp.suggestSnippets": false, // 同上
}

compile_flags.txt

除非你不打算用clang,否則此文件對於本文的配置是必須創建的,且一定要是這個文件名,大小寫要也一樣。位置需要在你的工作區文件夾的磁盤根目錄。

例如你選擇的工作區文件夾在C盤裏(任何位置),那就需要創建一個C:\compile_flags.txt。可以先在桌面上創建這個txt,再複製/拖拽到C盤根目錄去(因爲有UAC限制無法直接創建);另外如果你的後綴是隱藏的,最好打開一下,自己百度。

-Wall
--target=x86_64-w64-mingw
#-std=c++17
#如果寫C++,就去掉上面一行最開頭的井號

(以下四行如果看不懂就不用管)

此文件是clangd爲了提供必須的功能所使用的,效果和直接把它們傳遞給clang.exe差不多。感興趣的可以參見:https://clangd.github.io/。其他大多數教程(其實是我見過的其它所有教程)因爲沒有選擇使用clangd所以沒創建這個文件。

clangd只會使用離要評估的文件最近的一個compile_flags.txt。對於我來說,我還創建了C:\VS-Code-C\compile_flags.txtC:\VS-Code-CPP\compile_flags.txt,再在前者里加一行-std=c11和在後者里加-std=c++17來使用最新的標準。這樣可以覆蓋general的配置,缺點是這樣代碼列表裏會多一個文件。

將此文件放在根目錄是確保--target參數是存在的,是最後的fallback,否則就報找不到頭文件的錯誤,Lint也幾乎沒用。 此參數的作用可以直接在本文內搜索,提了很多次。

比較坑的是,C和C++都會使用.h作爲頭文件,如果不加任何std,.c和.cpp能正確lint,但是.h會使用C的模式。對於fallback來說感覺沒什麼好辦法,只能靠大家手動指定了。

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是一種數據交換格式,<del>大部分是JavaScript的子集</del>現在變成完全子集了。在這裏就是用作配置文件。VSC和各個擴展會讀取json中的條目,來決定某些功能和行爲。

這麼多條目哪裏來的呢?這其實和API差不多。擴展開發者會把允許修改的選項“告訴”VSC,各個擴展的安裝頁面都有寫。作爲使用者,輸入的時候VSC會提示你哪些是可用的,所以其實很容易寫。

爲什麼要往json裏寫這麼多的東西?因爲VSC本身並沒有對C語言特別優待,對其他許多語言也一樣。另一個原因是我沒用過lldb,就必須使用cpptools加gdb來調試,兩個擴展有一些功能重複,導致配置變得複雜。

以$開頭的是VSC預定義的變量,具體參見:Variables Reference。比如$file在實際運行時會替換成當前打開的文件名。

3. 寫代碼,編譯,調試

新建文件後就可以寫代碼了,c語言源代碼後綴是.c,c++是.cpp或.C或.cxx(這也要我教嗎……)。代碼文件在保存工作區內都可以,可以自己建立文件夾,不必放到.vscode文件夾裏,但路徑裏(包括文件名)不要含有中文和引號,最好不要有空格。(主要是許多符號是有效的shell語法,不然試試Linux下用rm刪除一個叫做-rf的文件?沒查過絕對寫不出來)

按Alt+Shift+F(或者用右鍵菜單)可以格式化代碼,第一次用的時候右下角會提示選擇格式化提供程序,如果你喜歡大括號換行就選C/C++,喜歡不換行就選vscode-clangd。出現Intellisense的時候按tab可以補全代碼。打出snippets時會出現多個跳轉點,按tab可以跳到下一個去。

停止輸入一小段時間(一秒)後就會有Lint,擴展會給一些建議性的warning(比如聲明瞭變量但不使用),自己清楚就行。如果覺得不爽,也有方法不讓它提示,比如去掉-Wall就會少一些。如果還想去掉更多的警告,我提示一下:-Wno-...。找好參數後可以用#pragma GCC diagnostic ignored或者加到各種Flags裏。總之自己研究。

按Ctrl+Shift+B單純編譯,按F5爲編譯加運行加調試;本來ctrl+F5爲運行但不調試,但現在cpptools暫不支持,還是會調試。Follow: How to launch an application without debugging? · Issue #1201 · Microsoft/vscode-cpptools

在寫程序初期,我強烈建議不要把f5當作編譯來使用,因爲有的bug只會產生警告,不會阻止編譯,但這些東西越早期解決越好。編譯信息會在底下的“終端”面板裏,如果代碼有錯誤,點進去可以看clang報的信息;不過因爲有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等。

如果你想使用別人的庫,比如ffmpeg,可能需要在命令中指定-I-l(小寫的L)、-L。具體參數閱讀那個庫的文檔。還可能需要把路徑添加到c_cpp_properties.json和compile_flags.txt裏來配置Intellisense。

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

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

保存文件夾

以後寫代碼必須打開之前那個建立好的文件夾才能寫,否則所有的Intellisense都沒有,只有Code Runner能用。

可以創建一個快捷方式(右鍵新建),把工作區路徑作爲參數傳給VSC主程序,記得打雙引號;還可以加個圖標。1.18有了真正的虛擬工作區,可以一個窗口包含多個不在一起的文件夾,“文件”菜單裏也有“保存工作區”這個功能,但是我都沒試過,不保證沒問題。

清理臨時文件

按照這樣配置,長期編譯代碼下來肯定有一大堆的exe,還可能分散在不同的文件夾裏。

可以考慮修改一下json文件,把生成文件的目錄指定到一個專門放exe的文件夾裏;如果不會,百度gcc使用教程以及看我的json裏的註釋。或者資源管理器右上角搜索*.exe然後手動刪除。

也可也寫個bat,放到工作區裏,要用的時候右鍵Run Code:

del *.exe /q /s
del tempCodeRunnerFile.c /q /s
del a.out /q /s
del *.o /q /s

添加純英文輸入法

Windows 10,默認輸入法只有一個微軟拼音,按一次shift就能進行中英轉換;爲了保持兼容,按ctrl加空格也能進行中英轉換,但這個快捷鍵正是強制觸發Intellisense的快捷鍵。

所以,我強烈建議手動添加“英語”語言輸入法,正常代碼時切換到純英文輸入法(win+空格),在需要頻繁中文註釋或者在字符串裏寫中文時才用中文輸入法的英文模式。

這樣也可以解決某些遊戲需要用到shift鍵但同樣快捷鍵衝突的問題。具體操作可以自己百度,也可以看我寫的這篇有點複雜的文章:Windows 切換顯示語言與添加純英文輸入法

某些可能出現的錯誤

爲了閱讀的連貫性,這一部分移動到第11點,遇到問題優先查看那裏是否已經提了。

4. 其他設置

我的一些其他的設置,用在全局settings.json裏,根據自己的情況調整,不需要全部照着我的寫。寫完一個以後要打逗號;最外面的那個大括號我沒加,就別弄丟了

現在的VSC用的是可視化的設置界面,其實原本是手動編輯且出現兩列設置的。點擊右上角那個花括號就能手動編輯。

"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,所以就無解。如果你確定需要用printf輸出中文,可以自己進行修改編譯用gcc,Lint仍然可以用clang的。

另一種方法是用寬字符輸出,有點複雜,見:C語言與中文的一些測試 (Win, UTF8源碼)

當然,如果你不打算堅持用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. 找不到頭文件的錯誤

  • 沒有創建compile_flags.txt。如果沒做這一步,說明你是跳着讀的這篇文章,重看
  • gcc不在Path裏。回去看上面的驗證那一步
  • 手動配置了c_cpp_properties.json且包含的路徑不正確。如果沒有創建此文件就不用管
  • 重啓試試

如果你保證這幾點都符合要求,那我也沒什麼好辦法……要不就換其它答主的教程吧。

另一種找不到頭文件的錯誤:

這種情況是因爲clang的默認target爲msvc,需要加--target=x86_64-w64-mingw這個參數纔行。

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

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

10. 我編寫代碼的體驗

體積上,合併後的LLVM文件夾佔1.6g,VSC 0.2g,加上一些擴展。如果只是用來寫C,體積佔用並不算小。內存佔用還是比較少的(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,並不複雜,體驗一下英語的實際應用也不錯哦。

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

  • 如果你只寫了個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。

如果還有問題,可以試試改成gcc/g++編譯。比如現在C++ #include <bits/stdc++.h>會報'float.h' file not found,改成g++後就好了。我覺得這應該是庫的bug,反正我是不知道怎麼解決。要麼別用clang++,要麼試試WSL+Remote擴展。


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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章