背景

子供が大学の実習のためのC言語開発環境の構築に苦労していました。Windows11 の PC で、 MinGW とVSCode を使うことが推奨されているようなのですが、うまく構築できず、チューターの大学院生に聞いても解決しなかったとのことです。私もネット検索しながら手伝ったのですが、ぴったりの情報が意外と見つからず苦労したので、覚書として書いておくことにしました。

ポイント

古い環境の MinGW ではなくて新しい MinGW64 を使います。MinGW64 のインストールはアーカイブを展開して適切なフォルダーに置いて、パスを設定すればOKです。コンパイルに必要な gcc などとデバッグに必要な gdb は MinGW64 のアーカイブに含まれています。
ネット検索で出てくる情報では、VSCodeで "launch.json" を作成すると書かれているものが多いですが、これは必須ではありません。 "tasks.json" を作成すると書かれている情報もありますが、これはVSCodeでプロジェクトフォルダーを開くと自動で生成されます。また、プロジェクトフォルダーを開かず "tasks.json" が無い状態でも一応デバッグ可能です。
今回うまく構築できていなかった環境は古い MinGW を(不完全に)インストールしていて、コンパイルと実行はできるがデバッグはできないという状況でした。"launch.json" や "tasks.json" をいくら作ってもデバッグできないわけです。

手順

拡張子を表示

Windows11の初期状態では、エクスプローラーでファイルの拡張子が隠蔽されているので、表示->表示->ファイル名拡張子を選択して表示されるようにします。
(これは皆さんやっていますよね)

MinGW64をインストール

ダウンロード

https://github.com/niXman/mingw-builds-binaries/releases からアーカイブをダウンロードします。多数のファイルがありますが、ファイル名に "win32-seh-msvcrt" または "win32-seh-ucrt" が入ったものをダウンロードしましょう。今回、下表の2つのファイルについて動作を確認してみたのですが、デバッグ時の動作に一部違いがありました。

ファイル名	デバッグ動作
x86_64-14.2.0-release-win32-seh-msvcrt-rt_v12-rev0.7z	stdio.hまでステップインできる
x86_64-14.2.0-release-win32-seh-ucrt-rt_v12-rev0.7z	stdio.hにステップインできない

展開と移動

ダウンロードできたら、エクスプローラーの右クリックメニューで「すべて展開」を選んで展開します。
そこで展開された "mingw64" というフォルダーを丸ごと移動(またはコピー)するのですが、Cドライブ直下に "tools" という名前のフォルダーを作って、その配下に移動するのがお勧めです。今後、各種のツールをインストールする場合も、"tools" 配下のフォルダーに入れるようにすると、Cドライブ直下がすっきりします。名前は "tools"でなくてもかまいませんが、空白文字や日本語文字を含まない名前にしておきましょう。

環境変数の設定

エクスプローラーで "MinGW64" 配下の "bin" フォルダーを開いた状態でツールバーをクリックすると、このフォルダーのフルパスが出てくるので、Ctrl+C または右クリックメニューの「コピー」でコピーしておきます。

スタートメニューで "en" または "env" とタイプして「環境変数を編集」を選びます。

ここで "envi" までタイプしてしまうとなぜか「システム環境変数の編集」が出てきてしまうのですが、これを選んでしまうと、次の画面で「環境変数」ボタンを押さなくてはならず、もうひと手間かかってしまいます。

「環境変数の編集画面で、ユーザー環境変数の "Path" を選択して「編集」ボタンを押し、

「新規」ボタンを押します。

そこで Ctrl+V を押すと、先ほどエクスプローラーのアドレスバーでコピーしたパスが貼り付けられます。さらに下の「OK」ボタンを押してこの画面を閉じて、

さらに、前の「環境変数」画面の「OK」ボタンを押して、環境変数の設定を完了します。

このようにPathを適切に設定しておけば、VSCode側でMinGW64のツールを見つけてくれます。

VSCode をインストール

https://code.visualstudio.com/download から Windowsの x64用のインストーラーをダウンロードしてインストールします。インストール先はデフォルト設定でいいでしょう。

「追加タスクの選択」で

エクスプローラーのファイルコンテキストメニューに[Codeで開く]アクションを追加する
エクスプローラーのディレクトリコンテキストメニューに[Codeで開く]アクションを追加する

を追加しておきます。

使い方

プロジェクトフォルダーを用意

プロジェクトフォルダーを用意します。すでにソースコードがある場合はここに置きます。
このプロジェクトフォルダーに対して、エクスプローラーのメニューから「Codeで開く」を実行します。

現在のウィンドウ内のファイルの作成者を信頼するか聞いてくるので、Yesを押します。

ソースコードをこれから作る場合は EXPLORER ペインの右クリックメニューで "New File..."を選び、

ソースコードのファイル名をつけます。
プロジェクトフォルダーにすでにソースコードがある場合は、EXPLORER ペインに表示されているファイル名をクリックして開きます。

VSCodeがまっさらの状態だと、 "C/C++ Extension Pack" をインストールするか聞いてくるので "Install"を押します。

しばらく待つとインストールが完了します。
このタブは閉じてしまってOKです。

先ほど新規作成したソースコードのタブに、例えば次のようなソースコードを書いてみます。

test01.c

#include <stdio.h>

void main(void){
    for(int i=0; i < 8; i++){
        printf("%d\n", i);
    }
}

左側の、右向き三角と虫のアイコンをクリックして、"Run and Debug" ボタンを押します。

"C++ (GDB/LLDB)" を選びます。

"Run and Debug" ボタンを再び押します。
"C/C++:gcc.exe build and debug active file" を選びます。

CMake に関するダイアログが右下に出ますが、とりあえず無視しておいてOKです。

デバッガーが動作し、 DEBUG CONSOLE が流れていきます。

ソースコードの行番号の左側にマウスカーソルを合わせると "Click to add a breakpoint" と出るので、そのままクリックするとブレークポイントを設定することができます。

ブレークポイントを1つ以上設定して "Run and Debug" を押すと、最初に到達したブレークポイントで停止します。
"VARIABLES" で現在の変数の値を確認することができます。

デバッグツールバーの各ボタンを押すことで、続行、ステップオーバー、ステップイン、ステップアウト、リスタート、ストップの各操作をすることができます。

ここまでの操作で、プロジェクトフォルダーの配下に ".vscode" というフォルダーが生成されて、その配下に "tasks.json" というファイルが生成されています。

ここに必要な設定が記録されているので、次回以降はプロジェクトフォルダーを「Codeで開く」すれば、

"Run and Debug" ですぐにデバッグできます。
なお、標準出力・入力は TERMINAL タブで出力・入力されますので、他のタブに切り替わっている場合は再度切り替えて確認しましょう。

ところで、VSCodeでプロジェクトフォルダーを開かず ".vscode" フォルダーが作られなかった場合、 "tasks.json" ファイルも作られませんが、デバッグは可能です。ただし、"tasks.json" ファイルの情報がないため、"C++ (GDB/LLDB)" を選ぶ操作と "C/C++:gcc.exe build and debug active file" を選ぶ操作が毎回必要になります。

注意事項

MinGW Installer は使わない

sourceforge や softnic から MinGW Installer (mingw-get-setup.exe) がダウンロードできますが、古い環境であること、デフォルト選択肢が設定されていないことから、正しくインストールすることが困難です。これは使わないで、MinGW64を使うようにしましょう。

Code Runner は不要

VSCode上でCなどのプログラムを実行するためのプラグインで "Code Runner" というのがありますが、上記の "Run and Debug" で実行できるので不要でしょう。"Code Runner" ではデバッグができないので、少し複雑なプログラムを書いて意図通り動かないとバグ探しに苦労することになります。早めにデバッグに慣れておいたほうがいいでしょう。