VS Code で快適に C 言語開発を始めるための完全ガイド（2026 年版）

📚 目次

1. VS Code のインストールと公式 C/C++ 拡張機能の設定
2. C コンパイラの選択肢とインストール手順
3. Windows：MinGW‑w64
4. WSL2：gcc
5. macOS／Linux：clang
6. VS Code でのビルド・デバッグ設定
7. ポータブル USB 環境の構築手順
8. Makefile を利用した高度なビルド管理
9. Clang‑Format と静的解析ツールの導入
10. よくあるエラーと対処法（FAQ）
11. おすすめ VS Code 拡張機能リスト

1️⃣ VS Code のインストールと公式 C/C++ 拡張機能の設定

結論

VS Code は 公式サイトの同一 URL（https://code.visualstudio.com/Download）から常に最新ビルドが取得でき、2026 年版でもこの手順で問題ありません。
Windows では「User Installer」を選べば管理者権限不要でインストール完了です。

ポイント
初心者は「User Installer」だけで十分です。インストール時のオプションはデフォルト（ショートカット作成・PATH への自動追加）をそのまま受け入れてください。

C/C++ 拡張機能（Microsoft 製）の導入手順

1. VS Code 左側の 拡張機能 アイコン（四角が４つ並んだマーク）をクリック
2. 検索バーに C/C++ と入力し、最上位に表示される Microsoft の C/C++ を「インストール」
3. インストール後、VS Code を再起動すると自動で言語サーバーが有効化します

基本設定（settings.json）例

まとめ
公式拡張だけで IntelliSense、コード補完、デバッグのすべてが利用可能です。上記設定は「そのまま貼り付け」でも動作しますので、まずは試してみてください。

2️⃣ C コンパイラの選択肢とインストール手順

📌 Windows：MinGW‑w64 の導入

PATH への正しい追加方法（Qiita 記事の誤記を修正）

1. 「システム環境変数」→「Path」を編集
2. 新規で C:\MinGW\bin を貼り付ける際、二重引用符 (") は一切入れない
3. 誤って "C:\MinGW\bin" と記載すると Windows がパスを文字列として認識できず、「gcc が見つからない」エラーになります。

確認コマンド
cmd
gcc --version
でバージョン情報が表示されれば成功です。

📦 WSL2 上での gcc インストール（Ubuntu 推奨）

1. PowerShell（管理者）で以下を実行し、WSL2 と Ubuntu をインストール

powershell
wsl --install -d Ubuntu

1. Ubuntu ターミナルが起動したらビルドツール一式を取得

bash
sudo apt update
sudo apt install build-essential gdb -y

• build-essential には gcc, g++, make が同梱されています。
• デバッグは標準の GDB がそのまま利用可能です。

🍎 macOS / 🐧 Linux：clang のセットアップ

• 注意点：Homebrew 版 llvm は /usr/local/opt/llvm/bin に配置されるため、PATH に手動で追加しないと clang が見つかりません。

テストコマンド
bash
clang --version

3️⃣ VS Code でのビルド・デバッグ設定

tasks.json（ビルドタスク）— 例：gcc / g++ 用シェルスクリプト

build.sh（Unix 系）例

• ポイント：-g（デバッグ情報）と -O0（最適化無効）はデバッガの正確な挙動に不可欠です。

launch.json（デバッガ設定）— GDB と LLDB の共存例

• 外部コンソール を有効にすると、printf の出力が VS Code の統合ターミナルではなく別ウィンドウに表示され、デバッグ中の入出力が見やすくなります。

実行フロー（Run ボタン・ショートカット）

まとめ：ビルド・実行・デバッグはすべて VS Code の UI だけで完結します。毎回端末にコマンドを打ち込む必要はありません。

4️⃣ ポータブル USB 環境の構築手順

ディレクトリ構成例（USB メモリ直下）

1. VS Code Portable を公式ページの「Windows ZIP」からダウンロードし、USB ルートに解凍。
2. 前節でインストールした MinGW‑w64 の bin ディレクトリ全体を mingw-w64 フォルダーへコピー（PATH 設定は不要）。

設定ファイルの持ち出し方法

ポイント：VS Code Portable は data/extensions に拡張機能を保存するため、別の PC でも同じ USB を差し込むだけで環境が再現できます。管理者権限は一切不要です。

5️⃣ Makefile を利用した高度なビルド管理

なぜ Makefile が便利か？

• 複数ファイル・ライブラリの依存関係を自動解決
• make clean や make test といったカスタムコマンドが作成できる
• CI/CD パイプラインと同一のビルドロジックを共有可能

最小構成 Makefile（gcc 用）

• VS Code での使用：.vscode/tasks.json に make コマンドを呼び出すタスクを追加すれば、Ctrl + Shift + B だけで Makefile が実行されます。

6️⃣ Clang‑Format と静的解析ツールの導入

clang‑format の設定と自動適用

1. インストール（macOS は Homebrew、Linux はパッケージマネージャ）
   bash
# macOS
brew install clang-format
# Ubuntu
sudo apt install clang-format -y
2. プロジェクト直下に .clang-format を作成し、好みのスタイルを記述

1. VS Code の設定で「保存時に自動整形」を有効化

静的解析（clang‑tidy）を組み込む

• tasks.json に以下タスクを追加すると、Ctrl + Shift + B でコードチェックが走ります

効果：未使用変数や潜在的なバッファオーバーランなど、実行前に多くの問題を検出できます。

7️⃣ よくあるエラーと対処法（FAQ）

総合的なトラブルシューティング手順
1. ターミナルでコンパイラが直接呼び出せるか確認 (gcc --version, clang --version)。
2. VS Code の Output → C/C++ パネルでエラーメッセージをチェック。
3. settings.json と tasks.json のパス表記に二重引用符が入っていないか最終確認。

8️⃣ おすすめ VS Code 拡張機能リスト（C 開発者向け）

導入方法：拡張機能ビューで名前検索 → 「Install」→ 必要に応じて「Enable (Workspace)」を選択すれば、プロジェクトごとの設定が可能です。

🎯 次のステップ

1. 本記事通りに VS Code と公式 C/C++ 拡張 をインストール
2. お好みのコンパイラ（MinGW‑w64 / gcc / clang）を導入し、PATH が正しく設定されているか確認
3. tasks.json・launch.json を作成し、Ctrl + Shift + B と F5 でビルド・デバッグができることを体感
4. 必要なら Makefile、clang‑format、clang‑tidy を組み込んでコード品質を向上させる
5. USB ポータブル版を作成し、どこでも同一環境で開発できるようにする

これらの手順が完了すれば、2026 年最新版の VS Code + C/C++ 環境は万全です。さあ、コードを書いて実行し、デバッグしながら次世代のアプリケーション開発を楽しんでください！ 🚀