C/C++ 通用 MakefileGeneric Makefile for C/C++ Program==================================================Keywords: Makefile, make, Generic, C/C++Author: whyglinux (whyglinux AT hotmail DOT com)Date: 2006-03-04==================================================本文提供了一个用于对 C/C++ 程序进行编译和连接以产生可执行程序的通用 Makefile。在使用 Makefile 之前，只需对它进行一些简单的设置即可；而且一经设置，即使以后对源程序文件有所增减一般也不再需要改动 Makefile。因此，即便是一个没有学习过 Makefile 书写规则的人，也可以为自己的 C/C++ 程序快速建立一个可工作的 Makefile。这个 Makefile 可以在 GNU Make 和 GCC 编译器下正常工作。但是不能保证对于其它版本的 Make 和编译器也能正常工作。如果你发现了本文中的错误，或者对本文有什么感想或建议，可通过 whyglinux AT hotmail DOT com 邮箱和作者联系。 

此 Makefile 的使用方法如下： * 程序目录的组织 尽量将自己的源程序集中在一个目录中，并且把 Makefile 和源程序放在一起，这样用起来比较方便。当然，也可以将源程序分类存放在不同的目录中。 在程序目录中创建一个名为 Makefile 的文本文件，将后面列出的 Makefile 的内容复制到这个文件中。（注意：在复制的过程中，Makfile 中各命令前面的 Tab 字符有可能被转换成若干个空格。这种情况下需要把 Makefile 命令前面的这些空格替换为一个 Tab。） 将当前工作目录切换到 Makefile 所在的目录。目前，这个 Makefile 只支持在当前目录中的调用，不支持当前目录和 Makefile 所在的路径不是同一目录的情况。 * 指定可执行文件 程序编译和连接成功后产生的可执行文件在 Makefile 中的 PROGRAM 变量中设定。这一项不能为空。为自己程序的可执行文件起一个有意义的名子吧。 * 指定源程序 要编译的源程序由其所在的路径和文件的扩展名两项来确定。由于头文件是通过包含来使用的，所以在这里说的源程序不应包含头文件。 程序所在的路径在 SRCDIRS 中设定。如果源程序分布在不同的目录中，那么需要在 SRCDIRS 中一一指定，并且路径名之间用空格分隔。 在 SRCEXTS 中指定程序中使用的文件类型。C/C++ 程序的扩展名一般有比较固定的几种形式：.c、.C、.cc、.cpp、.CPP、.c++、.cp、或者.cxx（参见 man gcc）。扩展名决定了程序是 C 还是 C++ 程序：.c 是 C 程序，其它扩展名表示 C++ 程序。一般固定使用其中的一种扩展名即可。但是也有可能需要使用多种扩展名，这可以在 SOURCE_EXT 中一一指定，各个扩展名之间用空格分隔。 虽然并不常用，但是 C 程序也可以被作为 C++ 程序编译。这可以通过在 Makefile 中设置 CC = $(CXX) 和 CFLAGS = $(CXXFLAGS) 两项即可实现。 这个 Makefile 支持 C、C++ 以及 C/C++ 混合三种编译方式： o 如果只指定 .c 扩展名，那么这是一个 C 程序，用 $(CC) 表示的编译命令进行编译和连接。 o 如果指定的是除 .c 之外的其它扩展名（如 .cc、.cpp、.cxx 等），那么这是一个 C++ 程序，用 $(CXX) 进行编译和连接。 o 如果既指定了 .c，又指定了其它 C++ 扩展名，那么这是 C/C++ 混合程序，将用 $(CC) 编译其中的 C 程序，用 $(CXX) 编译其中的 C++ 程序，最后再用 $(CXX) 连接程序。 这些工作都是 make 根据在 Makefile 中提供的程序文件类型（扩展名）自动判断进行的，不需要用户干预。

Makefile 的内容如下：################################################################################# Generic Makefile for C/C++ Program## Author: whyglinux (whyglinux AT hotmail DOT com)# Date: 2006/03/04
# Description:#
The makefile searches in
directories for the source files# with extensions specified in
, then compiles the sources# and finally produces the
, the executable file, by linking
# the objectives.#
Usage:# $ make compile and link the program.# $ make objs compile only (no linking. Rarely used).# $ make clean clean the objectives and dependencies.# $ make cleanall clean the objectives, dependencies and executable.# $ make rebuild rebuild the program. The same as make clean && make all.#==============================================================================## Customizing Section: adjust the following if necessary.##=============================================================================# The executable file name.
# It must be specified.#
PROGRAM := a.out # the executable namePROGRAM :=# The directories in which source files reside.# At least one path should be specified.# SRCDIRS := .
# current directorySRCDIRS :=#
The source file types (headers excluded).# At least one type should be specified.# The valid suffixes are among of .c, .C, .cc, .cpp, .CPP, .c++, .cp, or .cxx.
# SRCEXTS := .c #
C program
# SRCEXTS := .cpp #
C++ program
# SRCEXTS := .c .cpp #
C/C++ programSRCEXTS :=# The flags used by the cpp (man cpp for more).# CPPFLAGS := -Wall -Werror # show all warnings and take them as errorsCPPFLAGS :=# The compiling flags used only for C.# If it is a C++ program, no need to set these flags.# If it is a C and C++ merging program, set these flags for the C parts.CFLAGS :=CFLAGS +=# The compiling flags used only for C++.# If it is a C program, no need to set these flags.# If it is a C and C++ merging program, set these flags for the C++ parts.CXXFLAGS :=CXXFLAGS +=# The library and the link options ( C and C++ common).LDFLAGS :=LDFLAGS +=## Implict Section: change the following only when necessary.##=============================================================================# The C program compiler. Uncomment it to specify yours explicitly.
#CC = gcc#
The C++ program compiler. Uncomment it to specify yours explicitly.
#CXX = g++#
Uncomment the 2 lines to compile C programs as C++ ones.
#CC = $(CXX)#
CFLAGS = $(CXXFLAGS)# The command used to delete file.#RM = rm -f## Stable Section: usually no need to be changed. But you can add more.##=============================================================================SHELL = /bin/shSOURCES = $(foreach d,$(SRCDIRS),$(wildcard $(addprefix $(d)/*,$(SRCEXTS))))OBJS = $(foreach x,$(SRCEXTS), \ $(patsubst %$(x),%.o,$(filter %$(x),$(SOURCES))))DEPS = $(patsubst %.o,%.d,$(OBJS)).PHONY : all objs clean cleanall rebuildall : $(PROGRAM)# Rules for creating the dependency files (.d).#---------------------------------------------------%.d : %.c @$(CC) -MM -MD $(CFLAGS) $<%.d : %.C @$(CC) -MM -MD $(CXXFLAGS) $<%.d : %.cc @$(CC) -MM -MD $(CXXFLAGS) $<%.d : %.cpp @$(CC) -MM -MD $(CXXFLAGS) $<%.d : %.CPP @$(CC) -MM -MD $(CXXFLAGS) $<%.d : %.c++ @$(CC) -MM -MD $(CXXFLAGS) $<%.d : %.cp @$(CC) -MM -MD $(CXXFLAGS) $<%.d : %.cxx @$(CC) -MM -MD $(CXXFLAGS) $<# Rules for producing the objects.#---------------------------------------------------objs : $(OBJS)%.o : %.c $(CC) -c $(CPPFLAGS) $(CFLAGS) $<%.o : %.C $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<%.o : %.cc $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<%.o : %.cpp $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<%.o : %.CPP $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<%.o : %.c++ $(CXX -c $(CPPFLAGS) $(CXXFLAGS) $<%.o : %.cp $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<%.o : %.cxx $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<# Rules for producing the executable.#----------------------------------------------$(PROGRAM) : $(OBJS)ifeq ($(strip $(SRCEXTS)), .c) # C file $(CC) -o $(PROGRAM) $(OBJS) $(LDFLAGS)else # C++ file $(CXX) -o $(PROGRAM) $(OBJS) $(LDFLAGS)endif-include $(DEPS)rebuild: clean allclean : @$(RM) *.o *.dcleanall: clean @$(RM) $(PROGRAM) $(PROGRAM).exe### End of the Makefile ## Suggestions are welcome ## All rights reserved ##################################################################################

下面提供两个例子来具体说明上面 Makefile 的用法。例一　Hello World 程序这个程序的功能是输出 Hello, world! 这样一行文字。由 hello.h、hello.c、main.cxx 三个文件组成。前两个文件是 C 程序，后一个是 C++ 程序，因此这是一个 C 和 C++ 混编程序。/* File name: hello.h* C header file*/
#ifndef HELLO_H#
define HELLO_H#ifdef __cplusplusextern "C" {#endif void print_hello();
#ifdef __cplusplus}#
endif#endif/* File name: hello.c* C source file.*/#include "hello.h"#include
void print_hello(){ puts( "Hello, world!" );}/* File name: main.cxx* C++ source file.*/#include "hello.h"int main(){ print_hello(); return 0;}建立一个新的目录，然后把这三个文件拷贝到目录中，也把 Makefile 文件拷贝到目录中。之后，对 Makefile 的相关项目进行如下设置：PROGRAM := hello
# 设置运行程序名SRCDIRS := . #
源程序位于当前目录下SRCEXTS := .c .cxx # 源程序文件有 .c 和 .cxx 两种类型CFLAGS := -g # 为 C 目标程序包含 GDB 可用的调试信息CXXFLAGS := -g # 为 C++ 目标程序包含 GDB 可用的调试信息由于这个简单的程序只使用了 C 标准库的函数（puts），所以对于 CFLAGS 和 CXXFLAGS 没有过多的要求，LDFLAGS 和 CPPFLAGS 选项也无需设置。经过上面的设置之后，执行 make 命令就可以编译程序了。如果没有错误出现的话，./hello 就可以运行程序了。如果修改了源程序的话，可以看到只有和修改有关的源文件被编译。也可以再为程序添加新的源文件，只要它们的扩展名是已经在 Makefile 中设置过的，那么就没有必要修改　Makefile。

例二　GTK+ 版 Hello World 程序这个 GTK+ 2.0 版的 Hello World 程序可以从下面的网址上得到：http://www.gtk.org/tutorial/c58.html#SEC-HELLOWORLD。当然，要编译 GTK+ 程序，还需要你的系统上已经安装好了 GTK+。跟第一个例子一样，单独创建一个新的目录，把上面网页中提供的程序保存为 main.c 文件。对 Makefile 做如下设置：PROGRAM := hello # 设置运行程序名SRCDIRS := .
# 源程序位于当前目录下SRCEXTS := .c #
源程序文件只有 .c 一种类型CFLAGS := `pkg-config --cflags gtk+-2.0` # CFLAGSLDFLAGS := `pkg-config --libs gtk+-2.0` # LDFLAGS这是一个 C 程序，所以 CXXFLAGS 没有必要设置——即使被设置了也不会被使用。编译和连接 GTK+ 库所需要的 CFLAGS 和 LDFLAGS 由 pkg-config 程序自动产生。现在就可以运行 make 命令编译、./hello 执行这个 GTK+ 程序了。参考资料： * Multi-file projects and the GNU Make utility Author: George Foot http://www.elitecoders.de/mags/cscene/CS2/CS2-10.html * GNU Make Manual http://www.gnu.org/software/make/manual/

有时间好好钻研一下