初心者向けC言語開発環境のインストールとプロジェクト構成ガイド

2026年5月18日

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

エンジニアの世界では、「いつでも動ける状態を作っておけ」とよく言われます。
技術やポートフォリオがあっても、自分に合う案件情報を日常的に見れていないと、いざ動こうと思った時に比較や判断が難しくなってしまいます。
普段から案件情報が集まる環境を作っておくと、良い案件が出た時にすぐ動きやすくなりますよ。
筆者自身も、メガベンチャー勤務時代に年収1,500万円を超えた経験があります。振り返ると、技術だけでなく「どんな案件や働き方があるか」を日頃から見ていたことが、キャリアの選択肢を広げるきっかけになりました。
このブログを読んでくれた方に感謝を込めて、実際に使っている情報収集サービスを紹介します。

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

Contents

1 開発環境のインストールとセットアップ
- 1.1 Windows：Visual Studio 2022 と MSVC コンパイラの導入
- 1.2 macOS と Linux：gcc／clang と VS Code の導入
2 プロジェクトディレクトリ構成と初期ファイル作成
- 2.1 推奨ディレクトリツリー
- 2.2 サンプルコード
3 ビルド設定：Makefile と CMake の基本
- 3.1 Makefile（約 30 行）
- 3.2 CMakeLists.txt（最小テンプレート）
4 IDE でのビルド・デバッグ環境構築（VS Code と Visual Studio）
- 4.1 VS Code：tasks.json と launch.json
- 4.2 Visual Studio 2022：空プロジェクトの作成
5 バージョン管理と実践的なビルド・エラーハンドリング
- 5.1 Git リポジトリの初期化と .gitignore の例
- 5.2 ビルド実行例と代表的エラーの対処法
  - 5.2.1 Make を使ったビルド
  - 5.2.2 CMake を使ったビルド
6 まとめ

スポンサードリンク

開発環境のインストールとセットアップ

この章では、初心者が C 言語開発を始めるために最低限必要なツール群を Windows と macOS / Linux に分けて紹介します。各プラットフォームで共通して求められるのは「コンパイラ」「エディタ（または IDE）」「ビルド支援ツール」の３点です。インストール手順と動作確認までを実際に手を動かしながら進められるよう、具体的なコマンド例も併記しています。

Windows：Visual Studio 2022 と MSVC コンパイラの導入

Windows 環境では Microsoft が提供する Visual Studio 2022 Community を利用すれば、C 言語向けのコンパイラ（MSVC）とデバッガが標準で揃います。追加で必要になるのは CMake と Git だけです。

https://visualstudio.microsoft.com/ja/downloads/ のページから 「Visual Studio 2022 Community」 をダウンロードし、インストーラを起動します。
「ワークロードの選択」画面で 「Desktop development with C++」 にチェックを入れます。この中に MSVC コンパイラと Windows 用 CMake ツールが含まれています。
必要に応じて 「CMake tools for Windows」 と 「Git for Windows」 も同時に選択してください（デフォルトでチェックされていることが多いです）。
インストール完了後、スタートメニューから 「x64 Native Tools Command Prompt for VS 2022」 を起動し、以下のコマンドでコンパイラが正しくインストールされたか確認します。

cmd cl /?

「Microsoft (R) C/C++ Optimizing Compiler …」とヘルプが表示されれば成功です。

macOS と Linux：gcc／clang と VS Code の導入

macOS では Xcode Command Line Tools、Linux 系ディストリビューションではパッケージマネージャ経由で gcc/clang を入手します。エディタは無料で軽量な Visual Studio Code を使用し、Microsoft が提供する C/C++ 拡張機能を追加すればコード補完やデバッグが可能になります。

OS	インストールコマンド例	バージョン確認
macOS	`xcode-select --install`	`gcc --version`、`clang --version`
Ubuntu / Debian 系	`sudo apt update && sudo apt install build-essential clang`	同上
Fedora / RedHat 系	`sudo dnf groupinstall "Development Tools"`	同上

https://code.visualstudio.com/ から VS Code をダウンロードし、インストールします。
起動後、左側の拡張ビューで 「C/C++」（Microsoft 製）を検索してインストールしてください。
ターミナルで gcc --version または clang --version が表示されれば、開発環境の構築は完了です。

プロジェクトディレクトリ構成と初期ファイル作成

プロジェクトを整理された形で管理すると、ビルドスクリプトやテストコード、ドキュメントが自然に分離され、後から拡張しやすくなります。ここでは 5 層ディレクトリ をベースにした構成例と、最小限のサンプルソースを示します。

推奨ディレクトリツリー

以下の構造は「コード」「ヘッダー」「ビルド成果物」「テスト」「ドキュメント」を明確に分離しています。build/ は .gitignore に入れてリポジトリに含めないようにしましょう。

my_c_project/
├─ src/          # *.c ソースファイル
│   ├─ main.c
│   └─ hello.c
├─ include/      # *.h ヘッダー
│   └─ hello.h
├─ build/        # ビルド生成物（Makefile・CMake が出力するディレクトリ）
├─ test/         # 単体テストコード
├─ docs/         # README や設計書
└─ .gitignore    # 後述

my_c_project/

├─ src/ # *.c ソースファイル

│ ├─ main.c

│ └─ hello.c

├─ include/ # *.h ヘッダー

│ └─ hello.h

├─ build/ # ビルド生成物（Makefile・CMake が出力するディレクトリ）

├─ test/ # 単体テストコード

├─ docs/ # README や設計書

└─ .gitignore # 後述

サンプルコード

include/hello.h

#ifndef HELLO_H
#define HELLO_H

/** 「Hello, World!」を標準出力に表示する関数 */
void say_hello(void);

#endif // HELLO_H

#ifndef HELLO_H

#define HELLO_H

/** 「Hello, World!」を標準出力に表示する関数 */

void say_hello(void);

#endif // HELLO_H

src/hello.c

#include &lt;stdio.h&gt;
#include &quot;hello.h&quot;

void say_hello(void) {
    printf(&quot;Hello, World!\n&quot;);
}

#include <stdio.h>

#include "hello.h"

void say_hello(void) {

printf("Hello, World!\n");

}

src/main.c（エントリーポイント）

#include &quot;hello.h&quot;

int main(void) {
    say_hello();
    return 0;
}

#include "hello.h"

int main(void) {

say_hello();

return 0;

}

この状態で gcc -Iinclude src/*.c -o build/hello とビルドすれば、build/hello（Windows は hello.exe）が生成されます。

ビルド設定：Makefile と CMake の基本

C 言語プロジェクトでは Make と CMake が代表的なビルド自動化ツールです。どちらも同じソース構成で利用できるように、変数名やディレクトリパスを明示的に定義しています。

Makefile（約 30 行）

以下は src/ と include/ を対象としたシンプルな Makefile です。$(BUILD_DIR) にオブジェクトファイルと実行バイナリが集められ、.gitignore に追加すればリポジトリが汚染されません。

# -------------------------------------------------
# コンパイラ・フラグ設定（環境に合わせて変更可）
# -------------------------------------------------
CC      := gcc
CFLAGS  := -Wall -Wextra -O2 -Iinclude
LDFLAGS :=
SRC_DIR := src
BUILD_DIR:= build

# ソースとオブジェクトの自動列挙
SRCS   := $(wildcard $(SRC_DIR)/*.c)
OBJS   := $(patsubst $(SRC_DIR)/%.c,$(BUILD_DIR)/%.o,$(SRCS))

TARGET := $(BUILD_DIR)/hello

.PHONY: all clean

# -------------------------------------------------
# ビルドターゲット
# -------------------------------------------------
all: $(TARGET)

$(TARGET): $(OBJS)
    $(CC) $(LDFLAGS) -o $@ $^

$(BUILD_DIR)/%.o: $(SRC_DIR)/%.c | $(BUILD_DIR)
    $(CC) $(CFLAGS) -c -o $@ $&lt;

# ビルドディレクトリが無い場合は作成
$(BUILD_DIR):
    mkdir -p $(BUILD_DIR)

# -------------------------------------------------
# 依存関係自動生成（ヘッダー変更時に再コンパイル）
# -------------------------------------------------
-include $(OBJS:.o=.d)
$(BUILD_DIR)/%.d: $(SRC_DIR)/%.c | $(BUILD_DIR)
    @set -e; rm -f $@; \
    $(CC) -MM $(CFLAGS) $&lt; &gt; $@.$$$$; \
    sed 's,\($*\)\.o[ :]*,$(BUILD_DIR)/\1.o $@ : ,g' &lt; $@.$$$$ &gt; $@; \
    rm -f $@.$$$$

# -------------------------------------------------
# クリーンアップ
# -------------------------------------------------
clean:
    rm -rf $(BUILD_DIR)

# -------------------------------------------------

# コンパイラ・フラグ設定（環境に合わせて変更可）

# -------------------------------------------------

CC := gcc

CFLAGS := -Wall -Wextra -O2 -Iinclude

LDFLAGS :=

SRC_DIR := src

BUILD_DIR:= build

# ソースとオブジェクトの自動列挙

SRCS := $(wildcard $(SRC_DIR)/*.c)

OBJS := $(patsubst $(SRC_DIR)/%.c,$(BUILD_DIR)/%.o,$(SRCS))

TARGET := $(BUILD_DIR)/hello

.PHONY: all clean

# -------------------------------------------------

# ビルドターゲット

# -------------------------------------------------

all: $(TARGET)

$(TARGET): $(OBJS)

$(CC) $(LDFLAGS) -o $@ $^

$(BUILD_DIR)/%.o: $(SRC_DIR)/%.c | $(BUILD_DIR)

$(CC) $(CFLAGS) -c -o $@ $<

# ビルドディレクトリが無い場合は作成

$(BUILD_DIR):

mkdir -p $(BUILD_DIR)

# -------------------------------------------------

# 依存関係自動生成（ヘッダー変更時に再コンパイル）

# -------------------------------------------------

-include $(OBJS:.o=.d)

$(BUILD_DIR)/%.d: $(SRC_DIR)/%.c | $(BUILD_DIR)

@set -e; rm -f $@; \

$(CC) -MM $(CFLAGS) $< > $@.$$$$; \

sed 's,$$*$\.o[ :]*,$(BUILD_DIR)/\1.o $@ : ,g' < $@.$$$$ > $@; \

rm -f $@.$$$$

# -------------------------------------------------

# クリーンアップ

# -------------------------------------------------

clean:

rm -rf $(BUILD_DIR)

ポイント

CFLAGS に -Iinclude を明示的に書くことで、ヘッダー検索パスの曖昧さを排除しています。
依存関係ファイル（.d）は自動生成されるので、ヘッダーを追加・変更しただけで再コンパイルが走ります。
$(BUILD_DIR) が一元管理になるため、IDE のビルド設定でも同じディレクトリを指定すれば衝突しません。

CMakeLists.txt（最小テンプレート）

CMake はプラットフォームごとのビルドツールを抽象化します。以下のスクリプトは 変数名を分かりやすく し、include/ と src/ のパスを明示的に設定しています。

# -------------------------------------------------
# CMake 基本情報
# -------------------------------------------------
cmake_minimum_required(VERSION 3.15)
project(MyCProject LANGUAGES C)

# ビルド成果物の出力先（ビルドディレクトリ直下の bin/）
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY &quot;${CMAKE_BINARY_DIR}/bin&quot;)

# -------------------------------------------------
# インクルードパスとソースファイルの列挙
# -------------------------------------------------
# include ディレクトリを検索パスに追加
target_include_directories(
    ${PROJECT_NAME} PRIVATE
    &quot;${PROJECT_SOURCE_DIR}/include&quot;
)

# src 配下の *.c をすべて取得（再帰的に探索）
file(GLOB_RECURSE PROJECT_SOURCES
     &quot;${PROJECT_SOURCE_DIR}/src/*.c&quot;)

# -------------------------------------------------
# 実行ファイルの生成
# -------------------------------------------------
add_executable(hello ${PROJECT_SOURCES})

# -------------------------------------------------

# CMake 基本情報

# -------------------------------------------------

cmake_minimum_required(VERSION 3.15)

project(MyCProject LANGUAGES C)

# ビルド成果物の出力先（ビルドディレクトリ直下の bin/）

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")

# -------------------------------------------------

# インクルードパスとソースファイルの列挙

# -------------------------------------------------

# include ディレクトリを検索パスに追加

target_include_directories(

${PROJECT_NAME} PRIVATE

"${PROJECT_SOURCE_DIR}/include"

)

# src 配下の *.c をすべて取得（再帰的に探索）

file(GLOB_RECURSE PROJECT_SOURCES

"${PROJECT_SOURCE_DIR}/src/*.c")

# -------------------------------------------------

# 実行ファイルの生成

# -------------------------------------------------

add_executable(hello ${PROJECT_SOURCES})

ビルド手順（ターミナル例）

mkdir -p build &amp;&amp; cd build          # ビルド用ディレクトリを作成して移動
cmake ..                           # CMake が Makefile か Ninja を生成
cmake --build .                    # 実際のビルド実行
./bin/hello                        # 実行確認（Windows は hello.exe）

mkdir -p build && cd build # ビルド用ディレクトリを作成して移動

cmake .. # CMake が Makefile か Ninja を生成

cmake --build . # 実際のビルド実行

./bin/hello # 実行確認（Windows は hello.exe）

ポイント

target_include_directories に PRIVATE を付けることで、外部プロジェクトからはインクルードパスが漏れないようにしています。
出力ディレクトリを ${CMAKE_BINARY_DIR}/bin と固定するので、IDE の「実行構成」でも同じパスを書くだけで済みます。
file(GLOB_RECURSE …) により新しい .c ファイルを追加した場合は CMake 再設定だけで自動的にビルド対象になります。

IDE でのビルド・デバッグ環境構築（VS Code と Visual Studio）

IDE を使うと「ビルド → デバッグ」の一連の流れがボタン一つで完結します。ここでは VS Code のタスク設定と、Visual Studio 2022 のプロジェクト作成手順を示します。

VS Code：tasks.json と launch.json

まずは Makefile または CMake を VS Code に登録し、デバッグ構成を紐付けます。以下の設定例は make 系ビルドに対応したものです（CMake 用は cmake --build . に置き換えてください）。

.vscode/tasks.json

{
    &quot;version&quot;: &quot;2.0.0&quot;,
    &quot;tasks&quot;: [
        {
            &quot;label&quot;: &quot;build (make)&quot;,
            &quot;type&quot;: &quot;shell&quot;,
            &quot;command&quot;: &quot;make&quot;,
            &quot;group&quot;: &quot;build&quot;,
            &quot;problemMatcher&quot;: [&quot;$gcc&quot;],
            &quot;detail&quot;: &quot;Makefile によるビルド&quot;
        },
        {
            &quot;label&quot;: &quot;clean&quot;,
            &quot;type&quot;: &quot;shell&quot;,
            &quot;command&quot;: &quot;make clean&quot;,
            &quot;group&quot;: &quot;none&quot;,
            &quot;problemMatcher&quot;: []
        }
    ]
}

{

"version": "2.0.0",

"tasks": [

{

"label": "build (make)",

"type": "shell",

"command": "make",

"group": "build",

"problemMatcher": ["$gcc"],

"detail": "Makefile によるビルド"

{

"label": "clean",

"type": "shell",

"command": "make clean",

"group": "none",

"problemMatcher": []

}

]

}

.vscode/launch.json（GDB デバッグ用）

{
    &quot;version&quot;: &quot;0.2.0&quot;,
    &quot;configurations&quot;: [
        {
            &quot;name&quot;: &quot;(gdb) Launch hello&quot;,
            &quot;type&quot;: &quot;cppdbg&quot;,
            &quot;request&quot;: &quot;launch&quot;,
            &quot;program&quot;: &quot;${workspaceFolder}/build/hello&quot;,
            &quot;args&quot;: [],
            &quot;stopAtEntry&quot;: false,
            &quot;cwd&quot;: &quot;${workspaceFolder}&quot;,
            &quot;environment&quot;: [],
            &quot;externalConsole&quot;: true,
            &quot;MIMode&quot;: &quot;gdb&quot;,
            &quot;preLaunchTask&quot;: &quot;build (make)&quot;
        }
    ]
}

{

"version": "0.2.0",

"configurations": [

{

"name": "(gdb) Launch hello",

"type": "cppdbg",

"request": "launch",

"program": "${workspaceFolder}/build/hello",

"args": [],

"stopAtEntry": false,

"cwd": "${workspaceFolder}",

"environment": [],

"externalConsole": true,

"MIMode": "gdb",

"preLaunchTask": "build (make)"

}

]

}

使い方の流れ

Ctrl+Shift+B → 「build (make)」 を選択しビルド。
ビルドが成功したら F5 でデバッグ開始。VS Code が自動的に preLaunchTask を実行するため、常に最新のバイナリが走ります。

Visual Studio 2022：空プロジェクトの作成

Visual Studio は GUI ベースでビルド・デバッグを行えるので、CMake に慣れていない人にも適しています。以下は 「空の C++ プロジェクト」 を利用した手順です（C 言語でも同様に扱えます）。

Visual Studio 2022 を起動し、メニューから 「新しいプロジェクトの作成」 → 「空のプロジェクト (C++)」を選択。
プロジェクト名は MyCProject、保存先はリポジトリと同じフォルダに設定します。
ソリューションエクスプローラーで右クリック → 「追加」→「既存項目」 を選び、src/*.c と include/*.h をすべて追加します。
プロジェクトのプロパティ画面を開き、「C/C++」→「全般」→「追加のインクルードディレクトリ」 に ${ProjectDir}\include を入力して OK。
メニューから 「デバッグ開始 (F5)」 を選ぶと、Visual Studio が内部で MSBuild を呼び出しビルド・実行を行い、ブレークポイントが有効になることを確認できます。

ポイント

空プロジェクトでも main.c がエントリーポイントとして認識されるので、Makefile や CMake の知識がなくてもすぐにコンパイル可能です。
インクルードディレクトリを明示的に設定するだけで、ヘッダーが見つからないエラーはほぼ防げます。

バージョン管理と実践的なビルド・エラーハンドリング

コードの履歴管理はチーム開発だけでなく、個人プロジェクトでも 「失敗した状態に戻せる」 という安全策になります。また、ビルド時に出やすいエラーへの対処法をまとめておくと、トラブルシューティングが格段に楽になります。

Git リポジトリの初期化と .gitignore の例

プロジェクトのルートで以下のコマンドを実行し、Git リポジトリを作成します。

bash git init git add . git commit -m "Initial commit – project skeleton"

ビルド生成物や IDE 固有ファイルは .gitignore で除外しましょう。

# -------------------------------------------------
# ビルド成果物
# -------------------------------------------------
/build/
/*.o
/*.obj
/*.exe
/*.out

# CMake が自動生成するファイル
CMakeCache.txt
CMakeFiles/
cmake_install.cmake
Makefile

# VS Code の個人設定
.vscode/

# Visual Studio のプロジェクト・ソリューション（必要なら除外しない）
*.vcxproj*
*.sln
*.user

# -------------------------------------------------

# ビルド成果物

# -------------------------------------------------

/build/

/*.o

/*.obj

/*.exe

/*.out

# CMake が自動生成するファイル

CMakeCache.txt

CMakeFiles/

cmake_install.cmake

Makefile

# VS Code の個人設定

.vscode/

# Visual Studio のプロジェクト・ソリューション（必要なら除外しない）

*.vcxproj*

*.sln

*.user

ビルド実行例と代表的エラーの対処法

Make を使ったビルド

make            # 成功すると build/hello が生成される
./build/hello   # 実行確認（Windows は .\build\hello.exe）

make # 成功すると build/hello が生成される

./build/hello # 実行確認（Windows は .\build\hello.exe）

CMake を使ったビルド

mkdir -p build &amp;&amp; cd build
cmake ..        # Makefile か Ninja の設定ファイルを生成
cmake --build . # ビルド実行
./bin/hello     # 実行確認

mkdir -p build && cd build

cmake .. # Makefile か Ninja の設定ファイルを生成

cmake --build . # ビルド実行

./bin/hello # 実行確認

エラーメッセージ	主な原因	修正例
`fatal error: hello.h: No such file or directory`	インクルードパスが未指定	Makefile の `CFLAGS += -Iinclude`、または CMake の `target_include_directories(... PRIVATE "${PROJECT_SOURCE_DIR}/include")` を追加
`undefined reference to 'say_hello'`	ソースファイルがリンク対象外	Makefile の `SRCS` に `src/hello.c` が入っているか確認、CMake で `file(GLOB_RECURSE …)` が正しくマッチしているか点検
`clang: error: no such file or directory: 'src/main.c'`	ビルドディレクトリから相対パスがずれている	ビルド前に `make clean` を実行し、作業ディレクトリをプロジェクト根に戻す

エラー対応の基本フロー

エラーメッセージ全体をコピーして検索エンジンで調べる。
「ヘッダーが見つからない」系は -I オプション、または CMake のインクルード設定を再確認。
「未定義シンボル」系はソースファイルの列挙漏れやオブジェクトファイルのリンク忘れが原因になるので、ビルド対象リストを目視でチェック。
修正後は make clean && make（または cmake --build . --clean-first）でクリーンビルドし、エラーが再発しないか確認する。

まとめ

Windows は Visual Studio 2022 の「Desktop development with C++」をインストールすれば MSVC と CMake が揃い、最小構成でもデバッグ機能が利用可能です。
macOS / Linux は標準のコンパイラ（gcc/clang）と無料エディタ VS Code を組み合わせるだけで十分な開発環境になります。
推奨ディレクトリ構造は src/ include/ build/ test/ docs/ の 5 層で、ビルドスクリプト（Makefile） と CMakeLists.txt を両方用意すれば、IDE に依存しない柔軟な運用が可能です。
IDE 設定は VS Code のタスク/ランチ構成、Visual Studio 2022 の空プロジェクトでそれぞれ 5 分程度で完了します。
Git によるバージョン管理と .gitignore の設定を忘れずに行い、ビルドエラーは「パス」「リンク対象」の二点を中心にチェックすれば、初心者でも安定した開発サイクルが回ります。

この手順通りに環境構築できたら、あとは 自分で小さなプログラムを書き、ビルド・デバッグを繰り返す だけです。実際にコードを書いてみることで、IDE の操作感やビルドシステムの挙動が身につきますので、ぜひ手元のマシンで試してみてください。

スポンサードリンク

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。