こんにちは！開発現場で日々、コードの美しさとパフォーマンスの限界を追い求めている先輩エンジニアです。
今回は、C++プログラマの間でいま最も熱い話題の一つである「C++20/23のモジュール（Modules）機能」を、Windows環境（MSYS2 / MinGW-w64）で最速かつ確実に動かす方法を徹底解説します。
「C++のビルドが遅い」「ヘッダーファイルのインクルード地獄（`#include` hell）から解放されたい」――そう思ったことはありませんか？
モジュールを使いこなせるようになると、コンパイル速度が劇的に向上し、マクロ汚染に怯える必要のない、極めてモダンでクリーンなC++開発が手に入ります。
今回はネットを検索してもなかなか情報が見つからない「MSYS2環境におけるGCCでのモジュールビルドの罠と正解」を、実例を交えて優しく、かつ深く紐解いていきましょう。これをマスターすれば、あなたの毎日のコーディングとビルドのストレスが劇的に軽くなりますよ。
—
1. なぜMSYS2とGCCによるC++モジュールなのだろう？
C++20で鳴り物入るで導入された「モジュール（`import`, `export`）」ですが、言語仕様としての策定と、コンパイラ（GCC, Clang, MSVC）側の実装・ビルドシステムの対応は、長らく複雑なパズルのような状態でした。
特にGCC（MinGW-w64）環境では、C++20モジュールはバージョン11から実験的に導入され、GCC 13 / 14に至ることで実用レベルに達しています。
Windows上でこれらをネイティブに、かつ最新のツールチェーンで手軽に試すためのベストプラクティスが、MSYS2を使うことです。MSYS2の `UCRT64` 環境を利用すれば、最新のGCCと、WindowsのモダンなUniversal CRT（UCRT）が統合された最高峰のコンパイル環境を手に入れることができます。
—
2. 開発環境のセットアップ（MSYS2 + 最新GCC）
まずは、C++20/23のモジュールを正しくコンパイルできる最新のGCC環境を構築します。
ステップ1: MSYS2のインストールとパッケージ更新
すでにMSYS2を導入している場合でも、モジュール機能のバグフィックスが反映された最新のGCCを使うために、必ずパッケージの全更新を行ってください。
MSYS2のターミナル（UCRT64環境）を開き、以下のコマンドを実行します。
パッケージデータベースとコアシステムを同期・更新
pacman -Syu
(※途中で「Core libraries updated. Please close this window…」と出たら、指示通りに一度ターミナルを閉じ、再度開き直してもう一度上記コマンドを実行してください)
ステップ2: 最新のGCC（C++20モジュール対応）とビルドツールの導入
GCC 14以降、あるいはパッチが当たったGCC 13.2以降であれば、モジュールのサポートがかなり安定しています。以下のコマンドでツールチェーンをインストールします。
UCRT64環境向けの最新GCC、Make、Gitをインストール
pacman -S –needed mingw-w64-ucrt-x86_64-toolchain \
mingw-w64-ucrt-x86_64-cmake \
mingw-w64-ucrt-x86_64-ninja
インストール完了後、正しく最新版が入っているか確認しましょう。
g++ –version
> 【出力例の目安】 `g++ (Rev3, Built by MSYS2 project) 14.2.0` のような表示が出ていれば完璧です。
—
3. 現場で躓きやすいポイント：モジュールのディレクトリ構造と仕組み
C++モジュールは、従来の `#include` のように「テキストを単純にコピペする」仕組みではありません。コンパイラがインターフェースを解析し、BMI（Binary Module Interface, バイナリ・モジュール・インターフェース）と呼ばれる中間ファイルを生成します。
GCCでモジュールを扱う場合、以下の厳格なルールを守る必要があります。
1. 拡張子: モジュールインターフェースファイルは通常 `.cppm` や `.ixx` を使います（GCCでは `.cpp` や `.cc` でも設定次第ですが、明確に区別するため `.cppm` が推奨されます）。
2. ビルドの順序: 「モジュール本体」をコンパイルしてBMIを作り、その後に「それをインポートする側」をコンパイルしなければなりません。
今回は、最もシンプルかつ理解しやすいように、手動のコマンドライン（および後述のMakefile）を通じて、この仕組みを肌で感じていただきます。
—
4. 実践：Hello Worldでモジュールの動作確認
それでは、実際にC++20モジュールを使ったプログラムを作成してみましょう。
適当な作業ディレクトリ（例: `~/cpp_modules_test`）を作成し、以下の2つのファイルを用意します。
ディレクトリ構成
cpp_modules_test/
├── greeter.cppm (モジュール定義)
└── main.cpp (モジュールを利用するメインプログラム)
① モジュールインターフェースファイル (`greeter.cppm`)
このファイルで、外部に公開する関数を定義します。
// greeter.cppm
// モジュール名を “Greeter” と定義し、外部へ公開(export)します
export module Greeter;
include
include
// 外部から利用できるように export キーワードを付与
export namespace Greeter {
void sayHello(std::string_view name) {
std::cout << "こんにちは、" << name << "さん！ C++20モジュール世界へようこそ。\n";
}
}
【解説】
- `export module Greeter;` で、このファイルが `Greeter` という名前のモジュールであることをコンパイラに伝えます。
- `export namespace …` で、名前空間ごと外部への公開を宣言しています。
② メインプログラム (`main.cpp`)
先ほど作成したモジュールを `#include` の代わりに `import` して使います。
// main.cpp
// #include
import Greeter;
int main() {
// Greeterモジュールで定義された関数を直接呼び出す
Greeter::sayHello(“MSYS2ユーザー”);
return 0;
}
【解説】
- `import Greeter;` がC++20のモジュール構文です。ヘッダーファイルと異なり、マクロの汚染を受けないため非常に高速かつ安全にインポートできます。
—
5. 肝となるコンパイル手順（GCCのフラグ設定）
ここが最重要ポイントです。GCCでC++モジュールをビルドするためには、適切なフラグと「ビルドの順序」を守る必要があります。
UCRT64のターミナルで、以下のコマンドを順番に実行してください。
ステップ1: C++20の有効化とモジュールのコンパイル
まず、モジュールインターフェース（`greeter.cppm`）をコンパイルし、BMI（バイナリインターフェースファイル）を生成します。
-std=c++20 を指定し、モジュールソースをコンパイル
g++ -std=c++20 -c greeter.cppm -o greeter.o
実行すると、カレントディレクトリに `greeter.o` とともに、GCC内部用のモジュールキャッシュディレクトリ（`.gcm` など）が自動生成されます。
ステップ2: メインプログラムのコンパイル
次に、メインプログラムをコンパイルします。この際、先ほどコンパイルしたモジュールのオブジェクトファイルも一緒に指定します。
g++ -std=c++20 -c main.cpp -o main.o
ステップ3: リンクして実行ファイルの生成
最後に、両方のオブジェクトファイルをリンクして実行ファイルを作ります。
g++ main.o greeter.o -o app.exe
さあ、実行してみましょう！
./app.exe
【実行結果】
こんにちは、MSYS2ユーザーさん！ C++20モジュール世界へようこそ。
見事にC++20モジュールが動きました！おめでとうございます。コンパイルエラーが出ず、一発でこの画面に出会えた時の感動はひとしおです。
—
6. 毎日の開発を楽にするための「Makefile」による自動化
毎回手動で複数のコマンドを叩くのは現実的ではありませんよね。実務やプライベートの開発では、依存関係を自動解決してくれるビルドシステム（CMakeやMakefile）を使いましょう。
ここでは、先ほどのビルド手順を自動化するシンプルな `Makefile` を紹介します。プロジェクトのルートに `Makefile` という名前で保存してください。
コンパイラとフラグの定義
CXX = g++
CXXFLAGS = -std=c++20 -Wall -Wextra
ターゲットとオブジェクトファイル
TARGET = app.exe
OBJS = greeter.o main.o
all: $(TARGET)
実行ファイルのリンク
$(TARGET): $(OBJS)
$(CXX) $(OBJS) -o $(TARGET)
モジュールファイルのコンパイル（依存関係：greeter.cppm）
greeter.o: greeter.cppm
$(CXX) $(CXXFLAGS) -c greeter.cppm -o greeter.o
メインファイルのコンパイル（依存関係：main.cpp と greeter.oの生成物）
main.o: main.cpp greeter.o
$(CXX) $(CXXFLAGS) -c main.cpp -o main.o
クリーンアップ
clean:
rm -f $(TARGET) .o .gcm
この `Makefile` を置いたディレクトリで、ターミナルから単に次のように打つだけで、依存関係を考慮したスマートなビルドが行われます。
ビルド実行
make
実行
./app.exe
掃除（クリーン）
make clean
これなら、コードを修正したあとも `make` と叩くだけで、変更されたモジュールと依存関係が正しく再ビルドされます。毎日のコーディングが劇的に楽になりますね！
—
先輩エンジニアからのアドバイス
C++20/23モジュールは、これからのC++開発の標準（デファクトスタンダード）になっていきます。ヘッダーファイルのインクルード順序に悩まされたり、巨大なテンプレートメタプログラミングでビルドが何分も待たされたりした悪夢は、モジュールによって過去のものになりつつあります。
MSYS2/MinGW-w64環境は、最新のGCCがいち早く手に入るため、こうした最先端の言語機能をローカルのWindows環境で試すには最高のプラットフォームです。
ぜひ今回の設定をベースに、自分だけのモジュールライブラリを作ってみてください。あなたのC++ライフが、より快適でエキサイティングなものになることを心から応援しています！