multiple definition of `xxxx`问题解决及其原理

    人有的时候就是这样，稍微知道点知识就觉着自己什么都会，就浮躁了，实际只是一瓶子不满半瓶子晃荡的状态，今天就写点基础的东西，也是当前遇到的，以前改改就过去了，没有深究其原因，今天就给它所清楚了，也算弥补以前的旧账。

    早上编译一段代码，出现了如下的错误：

   multiple definition of `xxxxx`错误出现了，MD是不是谁写代码没在.h文件加条件编译啊？仔细查看了代码发现确实加了条件编译。

#ifndef _TEST_H_

#define _TEST_H_

。。。

#endif

   不是这个问题。这个问题哪里引起的呢？重复定义的问题，在哪里出现的呢？

    要解决这个问题先来看看变量的定义和声明的区别。

    声明是向编译器介绍名字－－标识符，它告诉编译器“这个函数或变量在某处可找到，它的模样象什么”。而定义是说：“在这里建立变量”或“在这里建立函数”。它为名字分配存储空间。无论定义的是函数还是变量，编译器都要为它们在定义点分配存储空间。对于变量，编译器确定变量的大小，然后在内存中开辟空间来保存其数据，对于函数，编译器会生成代码，这些代码最终也要占用一定的内存。总之就是：把建立空间的声明成为“定义”，把不需要建立存储空间的成为“声明”。

    查看代码，确实我在一个.h文件中定义了一个变量，而这个.h文件被多个文件包含，单独编译都没有问题，但是到链接的时候就出现问题了。

#ifndef _TEST_H_

#define _TEST_H_

......

struct pdesc const cameractrl_params[] = {
{PT_STRI_, 0,  1, OFFSET(cameractrl, homecmd), "homecmd", 32, 0, NULL, NULL},
    {PT_STRI_, 0,  1, OFFSET(cameractrl, zoomctrl), "zoomctrl", 32, 0, NULL, NULL},
    {PT_STRI_, 0,  1, OFFSET(cameractrl, focusctrl), "focusctrl", 32, 0, NULL, NULL},
    {PT_STRI_, 0,  1, OFFSET(cameractrl, aperturectrl), "aperturectrl", 32, 0, NULL, NULL},
    {PT_NULL_, 0,  0, 0, "", 0, 0, NULL, NULL} /* PT_NULL means tail of struct pdesc array */
};

......

#endif

    一般在.h文件中定义一个变量声明时，在其他文件中只要包含了这个.h文件，编译的时候就会独立被编译器解释，然后每个.C文件会生成独立的标识符和符号表，所以上述代码在单独编译的时候并不会报错，语法是合法的。但是，最后在编译器链接的时候，就会将工程中所有的符号整合在一起，由于文件中有重复的变量，于是就会出现重复定义的错误,系统就是提示你“multiple definition of `xxx`”。

  进一步解释，我们可以这样想象编译每一个C源文件时，相当于一条有管道包围的纵向水流，二者互不干扰。当链接时两条原本相互独立的水管横向流了，所有就出现了重复的元素。所以当进行链接时就会出现重复定义的标示符。重复定义的标示符在这里只是变量，函数不会。因为函数确实只在.c中定义了一次，多次声明是没有问题的，而变量确实出现了两次定义。两次重复的变量定义链接器就不知道该已那个地址作为变量的内存，所以报错。

 

  怎么解决这个问题呢?

  其实只需要将全局变量定义从.h文件中挪到.c文件里，然后在.h文件中用extern做外部声明即可。即在.c文件中声明变量，然后在头文件.h所有的变量声明前加上extern，注意在.h文件中就不要对变量进行初始化赋值了。然后其他需要使用全局变量的.c文件中包含.h文件即可。编译器会为.c生成目标文件，然后链接时，如果该.c文件使用了全局变量，链接器就会链接到此.c文件。其他文件需要使用此全局变量也是同样的方式，目的其实只有一个，就是使变量在内存中唯一化。

 

 例子，上面代码如此修改就对了：

在test.c中定义

//test.c

......

struct pdesc const cameractrl_params[] = {
{PT_STRI_, 0,  1, OFFSET(cameractrl, homecmd), "homecmd", 32, 0, NULL, NULL},
    {PT_STRI_, 0,  1, OFFSET(cameractrl, zoomctrl), "zoomctrl", 32, 0, NULL, NULL},
    {PT_STRI_, 0,  1, OFFSET(cameractrl, focusctrl), "focusctrl", 32, 0, NULL, NULL},
    {PT_STRI_, 0,  1, OFFSET(cameractrl, aperturectrl), "aperturectrl", 32, 0, NULL, NULL},
    {PT_NULL_, 0,  0, 0, "", 0, 0, NULL, NULL} /* PT_NULL means tail of struct pdesc array */
};

......

在test.h中定义

//test.h

#ifndef _TEST_H_

#define _TEST_H_

......

extern struct pdesc const cameractrl_params[];

......

#endif

  这样，multiple definition of `xxxx`就搞明白了。

done