makeコマンドとMakefileの使い方｜ソースコードのビルドからCMakeとの違いまで

この記事のポイント

・Makefileのターゲット・依存・コマンドの3要素を理解できる
・configure → make → make install の流れと各ステップの役割がわかる
・makeコマンドのよく使うオプション（-n, -j, -C）を実践で使える
・CMakeとの違いと、どちらを使うべきか判断できる

# Makefileの基本書式
ターゲット: 依存ファイル1 依存ファイル2
	コマンド（先頭はタブ文字。スペース禁止）

# シンプルなCプログラムのMakefile例
CC = gcc
CFLAGS = -Wall -O2

myapp: main.o utils.o
	$(CC) $(CFLAGS) -o myapp main.o utils.o

main.o: main.c
	$(CC) $(CFLAGS) -c main.c

utils.o: utils.c utils.h
	$(CC) $(CFLAGS) -c utils.c

clean:
	rm -f myapp *.o

# カレントディレクトリのMakefileを実行（最初のターゲットが実行される）
make

# 特定のターゲットを指定して実行
make myapp

# ビルドをクリーンにする
make clean

[root@web01 httpd-2.4.62]# make
Making all in srclib/apr
make[1]: ディレクトリ '/usr/local/src/httpd-2.4.62/srclib/apr' に入ります
/bin/sh /usr/local/src/httpd-2.4.62/srclib/apr/libtool --silent --mode=compile
...（省略）...
make[1]: ディレクトリ '/usr/local/src/httpd-2.4.62/srclib/apr' から出ます
[root@web01 httpd-2.4.62]#

# CPUコア数を確認
nproc

# 実行例: 8コアなら -j8 で並列ビルド
make -j$(nproc)

# 基本的な実行（インストール先を/usr/localに設定）
./configure --prefix=/usr/local

# configureのオプションを確認する
./configure --help

# Apacheの場合の例
./configure \
  --prefix=/usr/local/apache2 \
  --enable-ssl \
  --enable-rewrite \
  --with-pcre=/usr/local/pcre

# configureエラーの例
configure: error: pcre2 library not found

# RHEL系でdevelパッケージをインストール
sudo dnf install pcre2-devel

# Ubuntu系でdevパッケージをインストール
sudo apt install libpcre2-dev

# ビルド実行（並列化で高速化）
make -j$(nproc)

# インストール（root権限が必要な場合が多い）
sudo make install

# インストール先を確認
ls /usr/local/apache2/bin/

# インストールを元に戻す（make install したものを削除）
sudo make uninstall

# 変数の定義と使い方
CC      = gcc
CFLAGS  = -Wall -O2 -g
LDFLAGS = -lm
TARGET  = myapp
SRCS    = main.c utils.c network.c
OBJS    = $(SRCS:.c=.o)         # .cを.oに置換

# 変数を使ったルール
$(TARGET): $(OBJS)
	$(CC) $(CFLAGS) $(LDFLAGS) -o $@ $^

# $@ : ターゲット名（myapp）
# $^ : 全ての依存ファイル（main.o utils.o network.o）
# $< : 最初の依存ファイル（main.o）

# .c から .o を生成するパターンルール（%がワイルドカード）
%.o: %.c
	$(CC) $(CFLAGS) -c $< -o $@

# これ1行で、main.c→main.o, utils.c→utils.o などを全てカバーできる

.PHONY: all clean install test

all: $(TARGET)

clean:
	rm -f $(TARGET) $(OBJS)

install: $(TARGET)
	install -m 755 $(TARGET) /usr/local/bin/

test: $(TARGET)
	./run_tests.sh

# -MMD でヘッダ依存を自動生成する設定
CC = gcc
CFLAGS = -Wall -O2 -MMD -MP
SRCS = main.c utils.c
OBJS = $(SRCS:.c=.o)
DEPS = $(SRCS:.c=.d)

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

%.o: %.c
	$(CC) $(CFLAGS) -c $< -o $@

# 自動生成した依存ファイルをインクルード
-include $(DEPS)

# タスクランナーとしてのMakefile例
.PHONY: all build test lint deploy clean

# ヘルプ表示（makeだけで使い方を表示）
help:
	@echo "利用可能なターゲット:"
	@echo "  make build   - ビルドを実行"
	@echo "  make test    - テストを実行"
	@echo "  make deploy  - 本番環境にデプロイ"
	@echo "  make clean   - ビルド成果物を削除"

build:
	@echo "ビルド開始..."
	go build -o bin/server ./cmd/server/

test:
	go test ./... -v

lint:
	golangci-lint run ./...

deploy: build test
	rsync -avz bin/server user@web01.example.com:/usr/local/bin/
	ssh user@web01.example.com "systemctl restart myapp"

clean:
	rm -rf bin/

# CMakeを使ったビルドの流れ
mkdir build && cd build
cmake ..                        # Makefileを生成
make -j$(nproc)                 # ビルド
sudo make install               # インストール

# またはcmake --buildで統一的に実行
cmake --build . --parallel $(nproc)

# configure 失敗後にログを確認
tail -50 config.log

# よくある原因の検索
grep "error:" config.log
grep "No such" config.log

# インストール済みのライブラリを確認
pkg-config --list-all | grep ssl

# 特定ライブラリのバージョンとコンパイルフラグを確認
pkg-config --modversion openssl
pkg-config --cflags --libs openssl

# 実行例
-I/usr/include/openssl
-lssl -lcrypto

# make clean: コンパイル生成物のみ削除（Makefile は残る）
make clean

# make distclean: configure が生成したファイルも削除（完全リセット）
make distclean

# distclean 後に再configure
./configure --prefix=/usr/local --enable-ssl

Makefile:5: *** missing separator.  Stop.

# RHEL系：開発ツールをまとめてインストール
sudo dnf groupinstall "Development Tools"

# Ubuntu系
sudo apt install build-essential

# gcc の確認
gcc --version

# インストール
sudo dnf install gcc gcc-c++

# インストール先のbinを確認
ls /usr/local/apache2/bin/

# PATH に追加（~/.bashrc に追記する）
export PATH=/usr/local/apache2/bin:$PATH

# 即時反映
source ~/.bashrc

# コマンドの場所を確認
which httpd

# エラー例
/usr/bin/ld: cannot find -lssl

# 原因と対処
# 1. devel パッケージが未インストール
sudo dnf install openssl-devel

# 2. ライブラリのパスが通っていない
echo $LD_LIBRARY_PATH
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH

# 3. ldconfig でライブラリキャッシュを更新
sudo ldconfig