はじめに

ひとこと

アクセスしていただきありがとうございます。
筆者がCの環境を構築するときにかなり苦戦したため、これから頑張ろうとされている方に同じ思いをして欲しくないと思い、この記事を投稿しました。

目的

VSCodeでC/C++の編集、実行ができる環境を構築する
（任意）VSCodeでC/C++のデバッグができる環境を構築する
（任意）構築した環境を更新する

検証済みの環境

64ビット の Windows11

お使いのWindowsが何ビットOSかを確認する方法はこちら
https://qiita.com/ochx/items/cc56b6f06fcee03dad96

管理者権限がある Windowsアカウント

ご注意

記事のすべての情報は 2025/03/18現在 のものです
ただし、画像の切り替えが完了していないため、画像が 実際とは異なる場合 があります
記事には Gemini Advancedが出力した内容のうち、筆者自身がソース元などを確認し正しいと判断したもの を含みます
エクスプローラーにおけるファイルとフォルダの コピー 、 切り取り 、 貼り付け 、削除などの基礎的な操作ができることを前提としています
「検証済みの環境」で記事の通りに構築しても、他の要因によって正常に動作しない可能性があります。その際はコメントしていただけますと対応いたします

この記事での略語

略語	正式名称
VSCode	Visual Studio Code

1. （環境を更新したい方向け）古いMinGWを削除する

ここでは、この記事の方法で構築された環境を用いて説明します。
この記事とは異なる方法で構築された環境の場合、フォルダのパスなどが異なる場合があります。

1. 既存のmingw64フォルダを削除します

エクスプローラー を開きます
ナビゲーションウインドウ（エクスプローラーの左側）の PC 内の Windows (C:) ドライブを開きます
Program Files (x86) フォルダを開きます
mingw64 フォルダを削除します

2. MinGWを準備する

1. MinGWの7zipファイルをダウンロードします

1つ目のURLから最新のバージョンのMinGWを直接、ダウンロードできます。
2つ目のURLから古いバージョンのMinGWを閲覧できます。

ダウンロードが完了したら、次に進んでください。

MinGW（ミンジーダブリュー）とはMinimalist GNU for Windowsの略称で、Windowsで GNUツールチェーン と GCC を利用できるようにする開発環境です。
MinGWについて筆者自身も説明できるほど詳しくなく、またここで説明するには長くなりすぎるため割愛させていただきます。
今回は C/C++をコンパイルするため にGCCを使用します。
GCC（ジーシーシー）とはGNU Compiler Collection（グヌーコンパイラコレクション）の略称で、 複数の言語をコンパイルできるコンパイラ群 です。

MinGWのファイル名に含まれる各単語の意味について
ファイル名の例: x86_64-14.2.0-release-win32-seh-ucrt-rt_v12-rev2

x86_64: これはターゲットとするアーキテクチャを示しています。x86_64は、64ビット版のx86アーキテクチャを指します。

14.2.0: これはGCCのバージョン番号を示しています。

release: これはビルドの種類を示しています。releaseは、安定版としてリリースされたビルドであることを意味します。

win32: これはスレッドモデルを示しています。win32は、Windowsが提供するWindows API （Win32 API）を意味します。

seh: これは例外処理の方式を示しています。sehは Structured Exception Handling の略で、Windows固有の例外処理機構を使用していることを意味します。

ucrt: これはCランタイムライブラリの種類を示しています。uvcrtは Universal C Runtime の略で、MinGWの生成する実行ファイルがWindows10以降のWindowsに標準的にインストールされているランタイムライブラリに依存することを意味します。

rt_v12: これはランタイムライブラリのバージョンを示しています。

rev1: これはリビジョン番号を示しています。バグ修正や細かな変更が行われた場合に、リビジョン番号が更新されることがあります。

2. ダウンロードした7zipファイルを展開します

エクスプローラー を開きます
ナビゲーションウィンドウ（エクスプローラーの左側）の ダウンロード フォルダを開きます
ダウンロードした7zipファイルを選択します
すべて展開 を選択します
> 新しく アーカイブ抽出 ウィンドウが開きます
完了時に展開されたファイルを表示する を選択します
展開を選択します
> 展開が始まり完了したら、アーカイブ抽出 ウィンドウが閉じ、新しくエクスプローラーが開きます

展開が完了したら、次に進んでください

Windows11（の特定のビルド）から、Windowsの機能として様々な形式の圧縮ファイルを展開できるようになりました

3. mingw64フォルダを移動させます

mingw64 フォルダを切り取ります
ナビゲーションウィンドウ（エクスプローラーの左側）の PC 内の Windows (C:) ドライブを開きます
Program Files (x86) フォルダを開きます
mingw64 フォルダを貼り付けます
> 新しく 対象のフォルダーへのアクセスは拒否されました ウィンドウが開きます
続行を選択します
> 対象のフォルダーへのアクセスは拒否されました ウィンドウが閉じ、貼り付けされます

Program Files (x86)フォルダに直接、展開することはできません。

環境を更新したい方向け
古いmingw64フォルダとパスが変わらない場合は、これで完了です。
「5. 正しく設定できたか確認します」で設定できているか確認してください。

4. 環境変数を設定します

mingw64 フォルダを開きます
bin フォルダを選択します
… を選択します
パスのコピー を選択します
設定を開きます
システム を選択します
バージョン情報 を選択します
デバイスの仕様 内の システムの詳細設定 を選択します
> 新しく システムのプロパティ ウィンドウが開きます
環境変数 を選択します
> 新しく 環境変数 が開きます
システム環境変数 内の Path を選択します
編集を選択します
> 新しく 環境変数名の編集 が開きます
新規を選択します

コピーしたアドレスをペーストし、文字列の先頭と末尾にある " を消します

// 間違っている例
"C:\Program Files (x86)\mingw64\bin"

// 正しい例
C:\Program Files (x86)\mingw64\bin

環境変数名の編集 の OK を選択します
> 環境変数名の編集 が閉じます
環境変数 の OK を選択します
> 環境変数 が閉じます
システムのプロパティ ウインドウの OK を選択します
> システムのプロパティ ウインドウが閉じます

ここまで完了したらエクスプローラーと設定は閉じても大丈夫です

これでbinフォルダ内のすべてのexeファイルを実行しやすくなります

5. 正しく設定できたか確認します

下記のコードをコピーします
```
gcc --version
```
コマンドプロンプト を開きます（「Windowsキー + Rキー」を押し、 cmd と入力し、「Enterキー」を押すと開きます）
コードをペーストします
Enterキー を押します

次のような出力になれば正しく設定できています

gcc (x86_64-win32-seh-rev0, Built by MinGW-Builds project) 14.2.0
Copyright (C) 2024 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.

ここまで完了したらコマンドプロンプトは閉じても大丈夫です

2. VSCodeを準備する

1. VSCodeをインストールします

Microsoft Store を開きます
上部の検索バーに vscode と入力し、検索します
VSCode をインストールします

インストールが完了したら、次に進んでください

ここまで完了したらMicrosoft Storeは閉じても大丈夫です

VSCodeはカスタマイズ性が高いソースコードエディタです
様々な拡張機能などによって、自分好みのエディタにすることができます

2. （日本語で使いたい方向け）Japanese Language Pack for Visual Studio Codeをインストールします

VSCode を開きます
左側のサイドバーの Extensions を選択します
Japanese Language Pack for Visual Studio Code と検索し、インストールします

インストールが完了したら、次に進んでください

～ Language Pack for Visual Studio Code はVSCodeを各言語で利用できるようにするための拡張機能です

3. （日本語で使いたい方向け）Japanese Language Pack for Visual Studio Codeを設定します

上部のメニューバーの View を選択します
Command Pallet を選択します
Configure Display Language と入力します
日本語(ja) を選択します
VSCode を再起動します

4. C/C++ Extension Packをインストールします

「2. （任意）Japanese Language Pack for Visual Studio Codeをインストールします」と同様の手順で C/C++ Extension Pack をインストールします
インストールが完了したら、 VSCode を再起動します

C/C++ Extension Pack　はC/C++の編集を便利にするための拡張機能をまとめたパッケージです

5. Code Runnerをインストールします

「2. （任意）Japanese Language Pack for Visual Studio Codeをインストールします」と同様の手順で Code Runner をインストールします
インストールが完了したら、 VSCode を再起動します

Code Runner はコードの実行を簡単にするための拡張機能です

5. Code Runnerを設定します

Code Runner の 「歯車」のアイコン を選択します
拡張機能の設定 を開きます
Run In Terminal をチェックします

これでターミナルから入力をできるようになります

3. C/C++ファイルを実行およびデバッグ(任意)できるか確認します

CとC++で共通している内容については、Cで説明しています。

1. C/C++ファイルを実行ができるか確認します

左上の ファイル を選択します
新しいテキストファイル を選択します
言語の選択 を選択します
C または C++ を選択します

次のサンプルコードをコピーし、エディタに貼り付けます
C の場合

#include <stdio.h>

void main(void) {
    printf("Hello World");
}

C++ の場合

#include <iostream>
using namespace std;

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

右上の Run Code を選択します
(コンパイラを尋ねられたら gcc を選択します)
下部に ターミナル が表示され、Hello World と表示されれば完了です

2. （デバッグしたい方向け）C/C++ファイルをデバッグできるようにします

デバッグしたいファイルのパスに日本語が含まれる場合、デバッグできない可能性があります

条件に当てはまるかを確認する方法

エクスプローラーを開く
デバッグしたいC/C++ファイルを選択する
右クリックでメニューを開きます
パスのコピーを選択します
コピーしたパスをメモ帳などに貼り付けし、日本語が含まれているか確認します

（「3. C/C++ファイルを実行およびデバッグ(任意)できるか確認します」の「1. C/C++ファイルを実行ができるか確認します」の続きです）

左上の ファイル を選択します
保存を選択します
任意の名前を付けて、任意のフォルダに保存します
例では、ファイル名を HelloWorld.c とします
C++の場合は、 HelloWorld.cpp としてください
左側のサイドバーの 実行とデバッグ を選択します
フォルダーを開いた を選択します
3でファイルを保存したフォルダを選択します
> VSCodeのウインドウが一度閉じ、再度開きます
左側のサイドバーの エクスプローラー を選択します
HelloWorld.c または HelloWorld.cpp を選択します
左側のサイドバーの 実行とデバッグ を選択します
launch.jsonファイルを作成します を選択します
C++ (GDB/LLDB) を選択します
元から書いてあるテキストをすべて削除します

以下のコードをコピーして、エディタに貼り付けます
"program"の値は、ファイル名と同じにしてください

launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Launch",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/HelloWorld.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${fileDirname}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "miDebuggerPath": "/path/to/gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

先ほど同じように、保存します
先ほど同じように、 エクスプローラー から HelloWorld.c または HelloWorld.cpp を選択します
4行目 の 4 の左側で、赤い丸が表示されるところにカーソルを移動させ、選択します
右上の三角を選択します
C/C++ ファイルのデバッグ を選択します
C/C++:gcc.exe アクティブファイルのビルドとデバッグ を選択します
デバッグが開始され、実行が4行目で停止すれば完了です

さいごに

ひとこと

最後までご覧いただきありがとうございます。
ご意見などがございましたら、遠慮なくコメントいただけると幸いです。
また、バージョンが変わっているなども報告いただけると助かります。