C言語

VSCode 2026でC言語開発環境を構築する完全ガイド

ⓘ本ページはプロモーションが含まれています

スポンサードリンク

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

結論

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

インストーラ主な特徴
User Installer個人ユーザー向け。%LOCALAPPDATA%\Programs\Microsoft VS Code に展開し、スタートメニューや PATH への自動登録が行われます。
System Installer全員共通の環境が必要な企業・教育機関向け。%ProgramFiles%\Microsoft VS Code 配下にインストールしますが、管理者権限が必須です。

ポイント
初心者は「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 の導入

項目推奨設定
配布元https://sourceforge.net/projects/mingw-w64/files/latest/download（公式ビルド）
インストーラ名mingw-w64-install.exe
インストール先例C:\MinGW\
主要オプションArchitecture → x86_64、Thread model → posix、Exception → seh

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 のセットアップ

OSインストールコマンド
macOS (Homebrew)brew install llvm
※インストール後は export PATH="/usr/local/opt/llvm/bin:$PATH" をシェル設定に追記
Ubuntu / Debiansudo apt update && sudo apt install clang lldb -y
Fedorasudo dnf install clang lldb -y
  • 注意点：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 ボタン・ショートカット）

アクション操作手順
ビルドCtrl + Shift + B → 「Build C program」タスクが走り、実行ファイルが生成される
実行（デバッグなし）エディタ右上の ▶︎（Run）ボタンをクリックすると、launch.json のデフォルト構成でプログラムが起動
デバッグ開始F5 キー → ブレークポイントが有効な状態で GDB/LLDB がアタッチし、ステップ実行や変数ウォッチが可能になる

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

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

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

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

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

ファイル配置場所内容
settings.json${workspaceFolder}/.vscode/コンパイラパスを相対参照に書き換える例：
"C_Cpp.default.compilerPath": "${workspaceFolder}/../mingw-w64/bin/gcc.exe"
tasks.json / launch.json${workspaceFolder}/.vscode/前述のビルド・デバッグ設定をそのままコピー
extensions.json（任意）${workspaceFolder}/.vscode/必要な拡張機能リストを記載し、USB 初回起動時に自動インストールさせることが可能

ポイント：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）

質問原因解決策
「gcc が見つからない」PATH に C:\MinGW\bin が登録されていない、または二重引用符が残っている環境変数 Path を開き、C:\MinGW\bin（引用符なし）を追加。変更後は VS Code と端末を再起動
「clang が見つからない」Homebrew でインストールした llvm の PATH が未設定export PATH="/usr/local/opt/llvm/bin:$PATH" をシェルの設定ファイル（.zshrc、.bash_profile）に追記
デバッグ時にブレークポイントが無視されるビルドに -g オプションが付いていない、または最適化 (-O2 以上) が有効build.sh／Makefile の CFLAGS に必ず -g -O0 を含める
「ファイルがロックされている」（Windows）ビルド後に実行ファイルが VS Code の統合ターミナルで開かれたままデバッグ構成の "externalConsole": true に変更し、ターミナルを閉じる
「clang-format が無視される」設定で editor.formatOnSave がオフ、または C_Cpp.clang_format_path が誤っている.vscode/settings.json へ正しいパスと formatOnSave:true を記述
「Makefile が無視される」tasks.json の command が make ではなく build.sh に固定されているtasks.json の該当タスクを "command": "make" に変更し、"problemMatcher": ["$gcc"] を残す

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

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

拡張機能主な機能インストール推奨度
C/C++ (Microsoft)IntelliSense、デバッグ、コードナビゲーション★★★★★
CMake ToolsCMake プロジェクトの自動検出・ビルド★★★★☆
CodeLLDBLLDB デバッガの高度な UI（macOS/Linux）★★★★☆
clang-format保存時自動コード整形★★★★★
Include Autocomplete#include パス補完★★★☆☆
Error Lensコンパイルエラー・警告をインライン表示★★★★☆
GitLensソース管理と変更履歴の可視化（必須ではないが便利）★★★★☆

導入方法：拡張機能ビューで名前検索 → 「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++ 環境は万全です。さあ、コードを書いて実行し、デバッグしながら次世代のアプリケーション開発を楽しんでください！ 🚀

スポンサードリンク

-C言語
-, , , , ,