在Ubuntu上利用VSCode建立C++開發環境的完整指南

想要開始C++開發，但在Linux（Ubuntu）中不知從何下手嗎？這篇文章介紹了在Ubuntu環境下進行C++開發的實際設置方法。特別是我們將教您使用VSCode，能夠從構建、執行到調試的完整開發環境。

在Windows上，人們通常使用Visual Studio，但在Linux上需要不同的設置。
本文整理了在Ubuntu Linux上建立C++開發環境，以及在VSCode中設置調試和構建自動化的方法。
文章依據步驟編排，讓C++初學者也能輕鬆跟隨。

1. 安裝必須的套件

sudo apt update
sudo apt install build-essential gdb

build-essential包含以下項目：

• g++ : C++編譯器
• gcc : C編譯器
• make : 構建自動化工具
• dpkg-dev 等等

2. 安裝VSCode（Snap方式）

sudo snap install code --classic

或者可以直接從 https://code.visualstudio.com 下載安裝

3. 安裝VSCode擴展

• C/C++ (由Microsoft提供)
• (選擇性) Code Runner: 快速執行代碼用

4. 創建專案目錄並準備示例檔案

mkdir ~/cpp_projects/helloworld
cd ~/cpp_projects/helloworld
code .

創建示例檔案 main.cpp:

#include <iostream>

int main() {
    std::cout << "Hello, C++!" << std::endl;
    return 0;
}

5. 設置 .vscode/tasks.json（自動構建）

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "構建C++檔案",
            "type": "shell",
            "command": "g++",
            "args": [
                "-g",
                "main.cpp",
                "-o",
                "main"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": ["$gcc"],
            "detail": "編譯main.cpp到main"
        }
    ]
}

可以通過 Ctrl + Shift + B 進行構建

6. 設置 .vscode/launch.json（調試）

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) 開啟",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/main",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "preLaunchTask": "構建C++檔案",
            "setupCommands": [
                {
                    "description": "為gdb啟用美化打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "設置反組譯風味為Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

可以通過 F5 來執行調試，程序將自動編譯並進入調試界面。

7. 編譯與執行總結

8. 附加提示

• g++ -g main.cpp -o main 命令包含了調試信息的編譯。
• 若增加其他 .cpp 檔案，必須在 args 中修改檔名。
• 若檔案數量較多，還可以擴展使用Makefile或CMake。

參考

• VSCode官方C++文檔
• gdb命令教程
• cppreference - 語言類型

作者註記

這種環境可以輕鬆地在個人伺服器、樹莓派、GCP VM等Linux基礎的系統上複製。 若與Python或C++ AI模組結合，這一結構將變成強大的基礎。