Visual Studio Code 適用的 C/C++

Name: Visual Studio Code
Author: Microsoft

Visual Studio Code 的 C/C++ 支援由 Microsoft C/C++ 擴充功能提供，讓您能在 Windows、Linux 及 macOS 上進行跨平台的 C 與 C++ 開發。當您建立 *.cpp 檔案時，此擴充功能會新增語法醒目提示（色彩標示）、智慧完成與浮動提示 (IntelliSense) 以及錯誤檢查等功能。

C++ language features

安裝擴充功能

開啟 VS Code。
選取活動列上的「擴充功能」檢視圖示，或使用鍵盤快速鍵 (⇧⌘X (Windows、Linux Ctrl+Shift+X))。
搜尋 'C++'。
選取安裝。

C/C++ extension

設定您的 C++ 開發環境

C++ 是一種編譯語言，這表示您的程式原始碼必須先經過翻譯（編譯）才能在電腦上執行。C/C++ 擴充功能不包含 C++ 編譯器或偵錯工具，因為 VS Code 作為編輯器，其開發工作流程依賴命令列工具。您需要安裝這些工具，或使用電腦上已安裝的工具。

檢查是否已安裝編譯器

注意：您的學術或工作開發環境可能已提供 C++ 編譯器和偵錯工具。請諮詢您的老師或同事，以取得安裝建議的 C++ 工具集（編譯器、偵錯工具、專案系統、Linter）的指導。

某些平台上預先安裝的常見編譯器包括 Linux 上的 GNU 編譯器集合 (GCC)，以及 macOS 上與 Xcode 搭配的 Clang 工具。

若要檢查是否已安裝這些工具

使用 (⌃⇧` (Windows、Linux Ctrl+Shift+`)) 開啟新的 VS Code 終端機視窗
使用下列指令檢查 GCC 編譯器 g++
```
g++ --version
```
或使用此指令檢查 Clang 編譯器 clang
```
clang --version
```

輸出應顯示編譯器的版本和詳細資訊。如果兩者都找不到，請確保您的編譯器執行檔位於您的平台路徑中（Windows 上為 %PATH，Linux 和 macOS 上為 $PATH），以便 C/C++ 擴充功能可以找到它。否則，請依照以下章節中的說明安裝編譯器。

安裝編譯器

如果您尚未安裝編譯器，可以依照我們的其中一個安裝教學課程進行

Windows:

Linux:

macOS:

注意：如果您偏好使用完整的整合式開發環境 (IDE)，包含內建的編譯、偵錯和專案範本（檔案 > 新增專案），則有許多選項可供選擇，例如 Visual Studio Community 版本。

範例：在 Windows 上安裝 MinGW-x64

為了瞭解這個流程，我們將透過 MSYS2 安裝 Mingw-w64。Mingw-w64 是 Windows 上受歡迎的免費工具集。它提供了 GCC、Mingw-w64 和其他有用的 C++ 工具和函式庫的最新原生版本。

使用 此 MinGW 安裝程式的直接連結 下載。
執行安裝程式並依照安裝精靈的步驟進行。請注意，MSYS2 需要 64 位元 Windows 8.1 或更新版本。
在精靈中，選擇您想要的安裝資料夾。請記下此目錄以供日後使用。在大多數情況下，建議的目錄是可以接受的。設定開始功能表捷徑的步驟也適用相同原則。完成後，請確保勾選 立即執行 MSYS2 方塊，然後選取完成。MSYS2 終端機視窗將會自動開啟。
在此終端機中，執行下列指令以安裝 MinGW-w64 工具鏈
```
pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain
```
將顯示可用套件清單
按下 Enter 鍵，接受 toolchain 群組中預設的套件數量。
當提示是否繼續安裝時，輸入 Y。
依照下列步驟，將您的 MinGW-w64 bin 資料夾路徑新增至 Windows PATH 環境變數
1. 在 Windows 搜尋列中，輸入設定以開啟您的 Windows 設定。
2. 搜尋 編輯您帳戶的環境變數。
3. 在您的 使用者變數 中，選取 Path 變數，然後選取編輯。
4. 選取新增，並將您在安裝過程中記錄的 MinGW-w64 目標資料夾新增至清單。如果您選擇了預設安裝步驟，則路徑為：C:\msys64\ucrt64\bin。
5. 選取確定，然後在 環境變數 視窗中再次選取確定，以更新 PATH 環境變數。您必須重新開啟任何主控台視窗，更新後的 PATH 環境變數才會生效。
若要檢查您的 MinGW-w64 工具是否已正確安裝並可用，請開啟新的命令提示字元並輸入
```
gcc --version
g++ --version
gdb --version
```
您應該會看到輸出顯示您已安裝的 GCC、g++ 和 GDB 版本。如果情況並非如此，請確保您的 PATH 項目與 Mingw-w64 二進位檔案位置（編譯器工具所在位置）相符，或參考疑難排解章節。

建立 Hello World 應用程式

為確保編譯器已正確安裝和設定，讓我們建立一個 Hello World C++ 程式。

建立 C++ 檔案

在 Windows 上，啟動 Windows 命令提示字元（在 Windows 搜尋列中輸入 Windows 命令提示字元）。在 macOS 和 Linux 上，您可以在終端機中輸入這些指令。
執行下列指令。這些指令會建立一個名為 projects 的空資料夾，您可以在其中放置所有 VS Code 專案。接下來的指令會建立一個名為 helloworld 的子資料夾並導覽至該處。從該處，您將使用 code 指令直接在 VS Code 中開啟 helloworld。
```
mkdir projects
cd projects
mkdir helloworld
cd helloworld
code .
```
「code .」指令會在目前的處理資料夾中開啟 VS Code，此資料夾將成為您的「工作區」。由於這是您建立的資料夾，請選取 是，我信任作者 來接受工作區信任對話方塊。
現在，使用檔案總管中的 新增檔案 按鈕或檔案 > 新增檔案 命令來建立一個名為 helloworld.cpp 的新檔案。

新增 Hello World 原始碼

貼上以下原始碼

#include <iostream>

int main()
{
    std::cout << "Hello World" << std::endl;
}

現在按下 ⌘S (Windows、Linux Ctrl+S) 來儲存檔案。您也可以在主檔案功能表中勾選 自動儲存，以啟用自動儲存來自動儲存您的檔案變更。

執行 helloworld.cpp

請確保 helloworld.cpp 已開啟，使其成為編輯器中的作用中檔案。
按下編輯器右上角的執行按鈕。
從您系統上偵測到的編譯器清單中，選擇 C/C++：g++.exe 建置並偵錯作用中檔案。

您只會在第一次執行 helloworld.cpp 時被提示選擇編譯器。此編譯器將成為您 tasks.json 檔案中設定的「預設」編譯器。
建置成功後，您應該會在整合式終端機中看到「Hello World」出現。

恭喜！您剛剛在 VS Code 中執行了您的第一個 C++ 程式！下一步是透過下一節中的其中一個教學課程，了解 Microsoft C/C++ 擴充功能的更多語言功能，例如 IntelliSense、程式碼導覽、建置組態和偵錯。

教學課程

透過適用於您環境的教學課程，開始使用 C++ 和 VS Code

說明文件

您可以在 VS Code 網站的 C++ 區段中找到更多關於使用 Microsoft C/C++ 擴充功能的說明文件，其中包含關於下列主題的文章

C++ TOC on code.visualstudio.com

遠端開發 (Remote Development)

VS Code 和 C++ 擴充功能支援遠端開發，讓您能夠透過 SSH 在遠端機器或虛擬機器上、Docker 容器內或適用於 Linux 的 Windows 子系統 (WSL) 中工作。

若要安裝遠端開發支援

安裝 VS Code 遠端開發擴充功能套件。
如果遠端原始檔案託管在 WSL 中，請使用 WSL 擴充功能。
如果您是透過 SSH 連線到遠端機器，請使用 Remote - SSH 擴充功能。
如果遠端原始檔案託管在容器中（例如 Docker），請使用 Dev Containers 擴充功能。

使用 AI 強化程式碼完成功能

GitHub Copilot 是一款由 AI 驅動的程式碼完成工具，可協助您更快、更智慧地撰寫程式碼。您可以在 VS Code 中使用 GitHub Copilot 擴充功能來產生程式碼，或從其產生的程式碼中學習。

GitHub Copilot 針對眾多語言和各式各樣的框架提供建議，對於 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++ 尤其有效。

您可以在 Copilot 說明文件中了解更多關於 Copilot 的入門資訊。

意見回饋

如果您在使用 Microsoft C/C++ 擴充功能時遇到任何問題或有任何建議，請在 GitHub 上提交問題和建議。如果您尚未提供意見回饋，可以參與這項快速問卷調查。

4/8/2026