C สร้าง build ด้วย Make



พอมีหลายไฟล์ การพิมพ์ gcc ทุกครั้งน่าเบื่อและช้า (คอมไพล์ใหม่หมดทุกครั้ง) Make แก้ปัญหานี้ — บอกครั้งเดียวว่าอะไรขึ้นกับอะไร แล้วมันสร้างใหม่เฉพาะที่จำเป็น

Makefile แรก

prog: main.c mathutil.c mathutil.h
	gcc -std=c17 -Wall -Wextra -o prog main.c mathutil.c
  • บรรทัดแรก: target: prerequisites — “prog ขึ้นกับไฟล์เหล่านี้”
  • บรรทัดถัดมา: recipe — คำสั่งที่สร้าง target ต้องขึ้นต้นด้วย Tab (ไม่ใช่ space!)
make            # รัน target แรก

Make เช็คว่า prog เก่ากว่า prerequisite ตัวไหนไหม — ถ้าใช่ รัน recipe; ถ้า prog ใหม่กว่าทุกตัว ไม่ทำอะไร (“prog is up to date”)

CC = gcc
CFLAGS = -std=c17 -Wall -Wextra -g

prog: main.o mathutil.o
	$(CC) $(CFLAGS) -o prog main.o mathutil.o

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

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

clean:
	rm -f prog *.o

ตอนนี้แก้แค่ main.c:

make
gcc -std=c17 -Wall -Wextra -g -c main.c
gcc -std=c17 -Wall -Wextra -g -o prog main.o mathutil.o

mathutil.o ไม่ถูกคอมไพล์ใหม่ เพราะ mathutil.c ไม่เปลี่ยน — โปรเจกต์ใหญ่ประหยัดเวลามหาศาล

ตัวแปร

CC = gcc
CFLAGS = -std=c17 -Wall -Wextra -g -O2
LDFLAGS = -lm                  # library ตอน link
TARGET = prog
OBJS = main.o mathutil.o list.o

อ้างด้วย $(NAME) โอเวอร์ไรด์ตอนเรียกได้: make CFLAGS="-O0 -g"

ตัวแปรอัตโนมัติใน recipe:

ความหมาย
$@ชื่อ target
$<prerequisite ตัวแรก
$^prerequisite ทั้งหมด
prog: $(OBJS)
	$(CC) $(CFLAGS) -o $@ $^ $(LDFLAGS)

pattern rule — กฎเดียวสำหรับทุก .c → .o

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

“ไฟล์ .o ใด ๆ สร้างจาก .c ชื่อเดียวกัน ด้วยคำสั่งนี้” — ไม่ต้องเขียนกฎซ้ำทุกไฟล์

Makefile ที่กระชับ:

CC = gcc
CFLAGS = -std=c17 -Wall -Wextra -g
OBJS = main.o mathutil.o

prog: $(OBJS)
	$(CC) $(CFLAGS) -o $@ $^

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

clean:
	rm -f prog $(OBJS)

.PHONY: clean

.PHONY — target ที่ไม่ใช่ไฟล์

clean, all, test, run ไม่สร้างไฟล์ชื่อนั้น — ประกาศ .PHONY เพื่อให้ Make รัน recipe เสมอ (ไม่งั้นถ้ามีไฟล์ชื่อ clean อยู่จริง Make จะคิดว่า “up to date”)

.PHONY: all clean test run

all: prog

run: prog
	./prog

test: prog
	./run_tests.sh

จัดการ dependency ของ header ให้ครบ

ถ้า main.c include mathutil.h และเราแก้ mathutil.h — main.o ควรคอมไพล์ใหม่ ต้องระบุใน prerequisite:

main.o: main.c mathutil.h
mathutil.o: mathutil.c mathutil.h

โปรเจกต์ใหญ่ให้ gcc สร้าง dependency ให้อัตโนมัติ:

CFLAGS += -MMD -MP
-include $(OBJS:.o=.d)         # include ไฟล์ .d ที่ gcc สร้าง

-MMD ทำให้ gcc เขียนไฟล์ main.d ที่มี main.o: main.c mathutil.h ... — Make อ่านเข้ามา

Makefile ที่ใช้จริงได้เลย

CC      = gcc
CFLAGS  = -std=c17 -Wall -Wextra -g -MMD -MP
LDFLAGS =
TARGET  = myprog
SRCS    = $(wildcard src/*.c)
OBJS    = $(SRCS:.c=.o)

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

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

.PHONY: clean run asan
clean:
	rm -f $(TARGET) $(OBJS) $(OBJS:.o=.d)

run: $(TARGET)
	./$(TARGET)

# clean แล้ว build ต่อ "ตามลำดับ" — ไม่พึ่งลำดับ prerequisite (make -j อาจสลับ)
asan:
	$(MAKE) clean
	$(MAKE) CFLAGS="$(CFLAGS) -fsanitize=address,undefined" $(TARGET)

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

asan: clean $(TARGET) (สอง prerequisite) ไม่กำหนดลำดับ — ใน make -j เป้าหมาย clean อาจรันคาบเกี่ยวกับ build หรือหลังจาก build เสร็จ ลบไฟล์ที่เพิ่งสร้าง เขียนเป็น recipe ที่เรียก $(MAKE) ต่อกันแทน (หรือใช้ build directory แยกสำหรับ sanitizer)

make            # build
make run        # build + รัน
make asan       # build ใหม่พร้อม sanitizer
make clean      # ลบ

เรื่องที่คนมักพลาด

  • ใช้ space แทน Tab หน้า recipe — Makefile:3: *** missing separator recipe ต้องขึ้นต้นด้วย Tab จริง ๆ
  • ไม่ประกาศ .PHONY: clean แล้วมีไฟล์ชื่อ clean — make clean บอก “up to date” ไม่ทำอะไร
  • ลืมใส่ header ใน prerequisite — แก้ .h แล้ว Make ไม่ rebuild ไฟล์ที่ใช้มัน (ใช้ -MMD -MP)
  • make แล้วไม่มีอะไรเกิดขึ้น — target up to date; make clean && make หรือ touch ไฟล์
  • recipe หลายบรรทัดคาดว่าตัวแปร shell ส่งต่อ — แต่ละบรรทัดรันใน shell ใหม่ ใช้ ;\ ต่อบรรทัด หรือ .ONESHELL:
  • $(CC) ไม่ตั้งค่า — Make มีค่า default cc ให้อยู่แล้ว แต่ตั้งเองชัดเจนกว่า
  • hardcode gcc ใน recipe แทน $(CC) — เปลี่ยนคอมไพเลอร์ไม่ได้ด้วย make CC=clang

สรุป

  • Makefile: target: prerequisites แล้วบรรทัดถัดมาเป็น recipe ขึ้นต้นด้วย Tab
  • Make สร้าง target ใหม่เฉพาะเมื่อ prerequisite ใหม่กว่า — incremental build ประหยัดเวลา
  • ตัวแปร: CC CFLAGS; อัตโนมัติ: $@ (target) $< (prereq แรก) $^ (ทั้งหมด)
  • pattern rule %.o: %.c — กฎเดียวครอบทุกไฟล์
  • .PHONY: clean run test สำหรับ target ที่ไม่ใช่ไฟล์
  • -MMD -MP + -include *.d ให้ gcc จัดการ header dependency อัตโนมัติ

บทถัดไปว่าด้วย static library — รวม .o หลายไฟล์เป็น .a และการออกแบบ header ของโมดูล