Post

GCC编译器的使用方法

1.编译流程

GCC编译器在编译C代码时需要经过以下4个步骤:

  • 预处理(preprocessing):对.c源文件进行预处理(头文件展开和宏替换),生成.i文件
  • 编译(compilation):对.i文件进行编译,生成.s汇编文件
  • 汇编(assembly):对.s文件进行汇编,生成.o目标文件
  • 链接(linking):将.o文件与库文件进行链接,生成可执行文件

2.gcc命令

2.1 命令格式

gcc命令格式及常用选项如下:

1
gcc [-c|-S|-E] [-std=standard] [-Idir] [-Ldir] [-o outfile] infile... [-lxxx]

infile参数是所有的输入文件,例如源文件、目标文件、库文件等。

默认情况下一次性完成预处理、编译和链接,即直接从源代码转换为可执行文件,也可以通过-c-S-E选项控制,见下一节。

编译C++代码应使用g++命令,格式同gcc。

2.2 常用选项

-o outfile:指定输出文件名

-E:仅对源文件进行预处理,不进行编译,如果未指定-o选项则结果输出到标准输出

-S:对源文件进行预处理、编译,不进行汇编,如果未指定-o选项则结果保存到与.c文件同名的.s文件

-c:对源文件进行预处理、编译和汇编,不进行链接,如果未指定-o选项则结果保存到与.c文件同名的.o文件

-std=standard:指定语言标准版本

-D name[=definition]:预定义宏,如果省略定义则默认为1

-Wall:打开所有编译警告

-Werror:将所有警告当成错误

-Idir:将指定路径添加到头文件搜索路径列表

-Ldir:将指定路径添加到库文件搜索路径列表

-lxxx:手动指定函数库xxx参与链接

3.示例

3.1 编译C代码

假设hello.h和hello.c定义了一个函数hello()

hello.h

1
void hello(const char *to);

hello.c

1
2
3
4
5
6
#include "hello.h"
#include <stdio.h>

void hello(const char *to) {
    printf("Hello, %s\n", to);
}

main.c包含了hello.h并调用了函数hello()

main.c

1
2
3
4
5
6
#include "hello.h"

int main() {
    hello("world");
    return 0;
}

以下命令将生成可执行文件hello_world:

1
gcc -o hello_world main.c hello.c

也可以分别执行编译和链接:

1
2
3
gcc -c -o hello.o hello.c
gcc -c -o main.o main.c
gcc -o hello_world main.o hello.o

程序输出结果如下:

1
2
$ ./hello_world 
Hello, world

3.2 编译C++代码

假设函数hello()使用C++实现:

hello.h

1
2
3
#include <string>

void hello(const std::string& to);

hello.cpp

1
2
3
4
5
6
#include "hello.h"
#include <iostream>

void hello(const std::string& to) {
    std::cout << "Hello, " << to << std::endl;
}

main.cpp内容同main.c,则编译命令只需将gcc改为g++:

1
g++ -o hello_world main.cpp hello.cpp

注意:在C++中,模板函数必须在头文件中定义,此时头文件也必须作为输入文件。

3.3 指定C++标准

可用-std参数指定C/C++标准版本,例如:

1
g++ -std=c++17 -o hello_world main.cpp hello.cpp

支持的C标准版本包括c90、c99、c11、c17等,C++标准版本包括c++98、c++11、c++14、c++17、c++20、c++23等。完整列表及默认值见 gcc文档 -std选项(默认值可能会随gcc版本变化)。

3.4 指定头文件搜索路径

GCC编译器默认的头文件搜索路径包括/usr/include(标准库头文件所在目录)、/usr/local/include等,可以使用-I选项指定自定义包含目录。

例如,如果头文件hello.h放在include目录中,include目录与main.cpp在同一目录下,则包含hello.h的语句应改为#include include/hello.h。另一种方法是使用-I选项:

1
g++ -o hello_world -Iinclude main.cpp hello.cpp

该选项可多次指定。

3.5 静态链接库

静态链接库(static library)是一组对象文件的集合,包含已经编译好的类或函数的代码,链接时将被包含到可执行文件中。静态链接库的优点是速度快,可执行文件可以直接使用;缺点是可执行文件体积大,当库文件发生变化时需要重新编译可执行文件。

静态库文件的命名格式为lib+名字+.a。例如,静态库foo的文件名为libfoo.a(在Windows系统上名为foo.lib)。

例如,将hello()函数编译为静态链接库hello,可使用以下命令:

1
2
g++ -c -o hello.o hello.cpp
ar rcs libhello.a hello.o

得到静态库文件libhello.a,其中ar是一个创建压缩文件的命令。

要在链接时使用静态库文件,有两种方式。假设libhello.a放在lib目录下,lib目录与main.cpp在同一目录下。第一种方式是使用-l选项指定库名称(即lib和.a之间的部分),-L选项指定库文件搜索路径:

1
g++ -o hello_world -Llib main.cpp -lhello

注意:-lhello必须放在main.cpp之后。

第二种方式是直接将库文件作为输入文件:

1
g++ -o hello_world main.cpp lib/libhello.a

静态链接的过程如下图所示:

静态链接

3.6 动态链接库

动态链接库也叫共享库(shared library),类似于静态链接库,但并不包含在可执行文件中,而是在程序运行时才会被加载。动态链接库的优点是可执行文件体积小,当库文件发生变化时不需要重新编译可执行文件;缺点是速度慢。

动态库文件的命名格式为lib+名字+.so。例如,动态库foo的文件名为libfoo.so(在Windows系统上名为foo.dll)。

例如,将hello()函数编译为动态链接库hello,可使用以下命令:

1
2
g++ -c -o hello.o -fPIC hello.cpp
g++ -shared -o libhello.so hello.o

动态库文件的使用方式与静态库类似:

1
g++ -o hello_world -Llib main.cpp -lhello

注意,这样生成的可执行文件不能直接运行,因为找不到动态库文件:

1
2
$ ./hello_world 
./hello_world: error while loading shared libraries: libhello.so: cannot open shared object file: No such file or directory

解决方法是将库文件所在路径添加到LD_LIBRARY_PATH环境变量:

1
2
3
$ export LD_LIBRARY_PATH=/path/to/lib
$ ./hello_world 
Hello, world

也可以将库文件放到系统默认的库文件搜索路径,例如/usr/lib、/usr/local/lib等。

使用动态库文件的另一种方式是直接将库文件作为g++命令的参数:

1
g++ -o hello_world main.cpp lib/libhello.so

这样生成的可执行文件会“记录”库文件路径,因此可以直接运行。

动态链接的过程如下图所示:

动态链接

3.7 指定库文件搜索路径

系统默认的库文件搜索路径包括/usr/lib、/usr/local/lib等,可以使用使用-L选项指定自定义库文件搜索路径,如3.5和3.6节所示。

参考

This post is licensed under CC BY 4.0 by the author.