実際に組んで動かす！C++ローカル開発環境構築ガイド

### C++開発を支える3大ツール

```
[ソースコード (.cpp / .h)]
│
▼
1. エディタ (VS Code) : コードを書く、コード補完、エラー表示
│
▼
2. CMake (ビルドツール) : 「どのファイルをどういう順でビルドするか」の設計図を作る
│
▼
3. コンパイラ (MSVC/GCC/Clang) : 人間の書いたコードをCPUが理解できる機械語（.exe / バイナリ）に変換
```

1. **エディタ / IDE（統合開発環境）**:
おすすめは **Visual Studio Code (VS Code)** です。軽量で、Windows/Mac/Linuxすべてで同じ操作感で動作します（Windowsなら **Visual Studio Community** も定番です）。
2. **コンパイラ**:
ソースコード（テキスト）を機械語（バイナリ）に変換するプログラム。OSごとに標準コンパイラが異なります。
- **Windows**: MSVC（Microsoft Visual C++）または MinGW (GCC)
- **Mac**: Apple Clang（Xcode Command Line Tools）
- **Linux**: GCC（GNU Compiler Collection）または Clang
3. **ビルドシステム（CMake）**:
ファイルが10個、20個と増えたとき、1つずつコマンドでコンパイルするのは不可能です。CMakeはクロスプラットフォームでビルドを全自動化してくれる世界標準ツールです。

### ① Windows の場合（最もおすすめ：Visual Studio Build Tools）

1. **Visual Studio Community** または **Build Tools for Visual Studio** を公式サイトからダウンロードして実行します。
2. インストーラーで **「C++ によるデスクトップ開発」** にチェックを入れてインストールします。
- これにより、世界最高峰のコンパイラ `cl.exe` (MSVC) とデバッガが自動導入されます。
3. （軽量派向け代替案）**MSYS2** を導入し、`pacman -S mingw-w64-ucrt-x86_64-gcc` で GCC をインストールする選択肢もあります。

---

### ② Mac の場合（Apple Clang）

ターミナルを開き、以下のコマンドを1行実行するだけです。

```bash
xcode-select --install
```

ダイアログが表示されたら「インストール」をクリックします。完了後、以下のコマンドでバージョンが出れば成功です。

```bash
clang++ --version
# Apple clang version 15.x.x ... と出ればOK！
```

---

### ③ Linux (Ubuntu / Debian) の場合（GCC）

ターミナルでパッケージマネージャから一発で入ります。

```bash
sudo apt update
sudo apt install build-essential gdb cmake -y
g++ --version
```

### VS Code にインストールすべき2つの拡張機能

VS Code の拡張機能タブ（Ctrl+Shift+X または Cmd+Shift+X）を開き、以下を検索してインストールします。

1. **`C/C++` (ms-vscode.cpptools)**:
Microsoft謹製。強力なコード補完（IntelliSense）、定義ジャンプ（F12）、デバッグ（ブレークポイント）を可能にします。
2. **`CMake Tools` (ms-vscode.cmake-tools)**:
CMakeLists.txt を検知し、エディタ下部のステータスバーに「ビルドボタン」「デバッグ実行ボタン」を自動配置してくれます。

```
[VS Code ステータスバー（CMake Tools導入後）]
[CMake: Debug] [Clang 15.0] [Build] [▶ 実行] [🐞 デバッグ]
```
これが入ると、複雑なコマンドを一切打たずに、下部の「Build」や「虫アイコン（デバッグ）」をクリックするだけで開発ができるようになります！

### プロジェクトのフォルダ構成例

```
my-cpp-project/
├── CMakeLists.txt <-- ビルド設定ファイル
└── src/
├── main.cpp <-- エントリポイント
├── Player.h <-- 自機クラス宣言
├── Player.cpp <-- 自機クラス実装
├── Enemy.h <-- 敵クラス宣言
└── Enemy.cpp <-- 敵クラス実装
```

### `CMakeLists.txt` の中身（そのまま使えます）

```cmake
# 1. 最小要求 CMake バージョン
cmake_minimum_required(VERSION 3.15)

# 2. プロジェクト名とバージョン
project(CppInvaderGame VERSION 1.0.0 LANGUAGES CXX)

# 3. C++17 標準を強制（モダンC++の機能を有効化）
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# 4. コンパイル警告を最大にしてバグを早期発見
if (MSVC)
add_compile_options(/W4)
else()
add_compile_options(-Wall -Wextra -Wpedantic)
endif()

# 5. ヘッダファイルの探索場所（include ディレクトリ）
include_directories(src)

# 6. 実行可能バイナリ（cpp_invader）の生成とソースファイル指定
add_executable(cpp_invader
src/main.cpp
src/Player.cpp
src/Enemy.cpp
)
```

#### ポイント解説
- `set(CMAKE_CXX_STANDARD 17)`: これを書くだけで、コンパイラが何であっても自動的に `-std=c++17` フラグが適用されます。
- `add_executable(アプリ名 ソースファイル一覧...)`: ここに新しく追加した `.cpp` ファイルを並べるだけで、自動で一括コンパイル＆リンクしてくれます。

### デバッグ実行の3ステップ

1. **ブレークポイントを打つ**:
`src/main.cpp` を開き、止めたい行の「行番号の左側」をクリックします。**赤い丸（●）**が点灯します。
2. **デバッグ開始（F5 または 虫アイコン）**:
VS Code のステータスバーにある「🐞（デバッグ実行）」を押すか、`F5` キーを押します。
- CMake が自動的に変更を検知してビルドを実行。
- プログラムが起動し、先ほど赤い丸を打った行で**黄色いハイライト**になってピタッと一時停止します！
3. **変数とステップ実行を確認する**:
- **左側の「変数」パネル**: その時点での変数の値（`x = 10`, `hp = 100` など）が生でリアルタイム表示されます。
- **F10（ステップオーバー）**: 次の1行を実行します。
- **F11（ステップイン）**: 呼び出している関数の中に入り込みます。
- **Shift+F5**: デバッグを終了します。

`printf` や `std::cout` でログを埋め込まなくても、デバッガを使えば**「プログラムを一時停止して、時間を止めた状態で中身を観察できる」**ようになります。

### エラー1：`fatal error: Player.h: No such file or directory`

- **症状**: コンパイルが始まってすぐに止まる。
- **原因**: コンパイラが「そんな名前のヘッダファイルは見当たらない」と怒っている。
- **処方箋**:
1. ファイル名のスペルミス（大文字・小文字の違いを含む）を確認する。
2. `#include "Player.h"` のパスが正しいか確認する（`src/` の中にあるなら `#include "src/Player.h"` か、CMakeLists.txt に `include_directories(src)` を追記する）。

---

### エラー2：`LNK2019 / undefined reference to 'Player::takeDamage(int)'`

- **症状**: コンパイル（.cppから.objへの変換）は通ったのに、最後の最後（リンク段階）で落ちる。
- **原因**: ヘッダで宣言された関数の**「実装（.cpp）がビルド対象に含まれていない」**。
- **処方箋**:
- `CMakeLists.txt` の `add_executable()` のリストに、`src/Player.cpp` を書き忘れていませんか？
- 実装ファイル（.cpp）を書き足すだけで一発解決します。

```
【エラーの発生場所を見分ける極意】
・「No such file / syntax error」 -> コンパイルエラー（コードの書き間違い）
・「undefined reference / LNK2019」 -> リンクエラー（cppファイルの指定漏れ）
```

• VS Code + CMake が現代C++の王道: CMakeLists.txtにソースを並べ、CMake ToolsでF5デバッグ。リンクエラー（LNK2019）はcppの指定漏れを疑うのが鉄則です。

• 1. C++コードを直接実行するWebブラウザ
• 2. OSやコンパイラの違いを吸収し、プロジェクト全体のビルド手順（MakefileやNinja/VSプロジェクト）を自動生成するビルドジェネレータ
• 3. C++の文法ミスを自動的に修正してコミットするAIツール
• 4. ソースコードを自動的に難読化するセキュリティソフトウェア

正解と解説を見る

正解：OSやコンパイラの違いを吸収し、プロジェクト全体のビルド手順（MakefileやNinja/VSプロジェクト）を自動生成するビルドジェネレータ
CMakeはクロスプラットフォームなビルドジェネレータであり、Windows/Mac/Linuxの違いを意識せずに同じ設定から各環境用のビルドファイルを生成します。

• 1. use_cpp_version(17)
• 2. set(CMAKE_CXX_STANDARD 17) と set(CMAKE_CXX_STANDARD_REQUIRED ON)
• 3. #define CPP_STANDARD 17
• 4. import cplusplus_17

正解と解説を見る

正解：set(CMAKE_CXX_STANDARD 17) と set(CMAKE_CXX_STANDARD_REQUIRED ON)
CMakeでは `set(CMAKE_CXX_STANDARD 17)` と `set(CMAKE_CXX_STANDARD_REQUIRED ON)` を記述することで、コンパイラ固有のフラグ（-std=c++17など）を自動適用します。

• 1. プログラムの実行速度を10倍高速にする
• 2. その行に処理が到達した瞬間にプログラムを一時停止させ、その時点でのメモリ状態や変数の値を検査できるようにする
• 3. その行のコードを永久に削除する
• 4. コード内のすべてのコメントを消去する

正解と解説を見る

正解：その行に処理が到達した瞬間にプログラムを一時停止させ、その時点でのメモリ状態や変数の値を検査できるようにする
ブレークポイントは指定した行でプログラムの実行を一時停止させ、変数ウォッチやコールスタック確認などの動的解析を行うための基本機能です。

• 1. パソコンの電源容量が不足している
• 2. ヘッダで宣言されている `Player::update()` の実装（.cppファイル）が CMakeLists.txt のビルド対象に含まれていない
• 3. VS Code のフォントサイズが小さすぎる
• 4. インターネット接続が切断されている

正解と解説を見る

正解：ヘッダで宣言されている `Player::update()` の実装（.cppファイル）が CMakeLists.txt のビルド対象に含まれていない
undefined reference / LNK2019 はリンカエラーの代表格であり、宣言に対する実装（.cpp）がビルド対象に追加されていない（リンクされていない）ことが原因です。