C语言 define 防止头文件重复包含 - C语言零基础入门教程

墨蓝 2022-09-10 03:25 234阅读 0赞

*  一.头文件重复包含编译器报错
    
     *  1.简单的理解头文件重复包
     *  2.老流氓的理解头文件重复包
 *  二.通过宏定义解决头文件重复包含
    
     *  1.通过 \#ifndef / \#define 解决头文件重复包含
     *  2.通过 \#pragma once 解决头文件重复包含
 *  三.通过插件 Visual Assist 设置快捷键解决文件重复包含
    
     *  1.安装插件 Visual Assist
     *  2.打开 VS，找到 VAssistX 选项
     *  3.设置模板内容
     *  4.点击 OK，设置完成
     *  5.快捷键测试
 *  四.猜你喜欢

> 零基础 C/C++ 学习路线推荐 : [C/C++ 学习目录][C_C_] >> [C 语言基础入门][C]

## 一.头文件重复包含编译器报错 ##

### 1.简单的理解头文件重复包 ###

假如头文件里有一行

int a=1;

包含两次就变成了

int a=1;
    int a=1;

于是[变量][Link 1]重复定义，编译器就会报错，[函数][Link 2]同理；

### 2.老流氓的理解头文件重复包 ###

你用过的套套肯定不会翻过来再用一遍;

## 二.通过宏定义解决头文件重复包含 ##

### 1.通过 \#ifndef / \#define 解决头文件重复包含 ###

#ifndef __XXX_H__
    #define __XXX_H__
    
    int a=1;
    
    #endif

上面的伪代码如下：

如果(没有定义宏__XXX_H__)
    {
        那么直接定义宏__XXX_H__
        定义变量a 并且赋值为 1
    }
    结束程序

*  假如第一次包含时，由于没有定义宏 \_\_XXX\_H\*\*，所以做了两件事，定义宏 \_\_XXX\_H\*\*，然后定义 int a = 1;
 *  假如第二次包含时，由于已经定义宏 \_\_XXX\_H\_\_，所以啥都不做；
 *  假如第 N 次包含时，由于已经定义宏 \_\_XXX\_H\_\_，所以啥都不做；
 *  **整个过程，无论头文件被包含多少次，变量 a 只被定义一次，不会有重复包含重复定义的问题存在！**

### 2.通过 \#pragma once 解决头文件重复包含 ###

\#pragmaonce 是上述方式的简写，好处是再也不会有两个头文件因为使用了同样的 \_\_XXX\_H\_\_ 而被忽略了

#pragmaonce
    
     ... ... // 声明、定义语句

## 三.通过插件 Visual Assist 设置快捷键解决文件重复包含 ##

虽然上面两种方式都能解决 [C/C++ 头文件重复包含冲突][C_C_ 1]问题，但是还有一种更快捷的方法，直接通过 Visual Assist 设置快捷键完成，操作步骤如下：

### 1.安装插件 Visual Assist ###

详细的安装流程请参考：[**安装 Visual Studio 插件 Visual Assist**][Visual Studio _ Visual Assist]

### 2.**打开 VS，找到 VAssistX 选项** ###

> 选择顶部菜单 VAssistX -> Code Generation and Refactoring -> Edit Refactoring Snippets

### 3.设置模板内容 ###

> 选择 Type –> All by shortcut，新建一个快捷方式：\*\* //t \*\* （快捷键：仅供参考，怎么顺手怎么来）

头文件模板内容如下：

#ifndef __$FILE_BASE_UPPER$_H__ //表示根据文件名字定义宏
    #define __$FILE_BASE_UPPER$_H__
    $end$
    #endif //__$FILE_BASE_UPPER$_H__

### 4.点击 OK，设置完成 ###

### 5.快捷键测试 ###

打开 vs，创建任意工程，添加头文件，使用快捷键 //t，例如，我项目添加了一个 test.h 文件，然后使用快捷键 //t，如下：

#ifndef __TEST_H__
    #define __TEST_H__
    
    #endif  //__TEST_H__

**推荐使用方法三**，因为 [Visual Assist][Visual Studio _ Visual Assist] 设置快捷键操作起来更方便快捷， Visual Assist 插件不仅能解决头文件重复包含问题，还能通过快捷键设置文件版权信息和作者信息，参考文章：[**Visual Studio 设置文件版权信息**][Visual Studio]

## **四.猜你喜欢** ##

1.  [C 语言 数组下标越界和内存溢出区别][C _]
2.  [C 语言 指针声明和定义][C _ 1]
3.  [C 语言 指针 p++ / p–][C _ _ p_ _ p]
4.  [C 语言 *p++/*§++/\_(p++)/\_p++][C _ _p_p_p]
5.  [C 语言 使用指针遍历数组][C _ 2]
6.  [C 语言 指针和数组区别][C _ 3]
7.  [C 语言 指针数组和数组指针区别][C _ 4]
8.  [C 语言 空指针 NULL][C _ _ NULL]
9.  [C 语言 void 指针][C _ void]
10. [C 语言 野指针][C _ 5]
11. [C 语言 函数值传递和址传递][Link 2]
12. [C 语言 函数缺省参数][C _ 6]
13. [C 语言 函数不定长参数][C _ 7]
14. [C 语言 函数指针][C _ 8]
15. [C 语言 指针函数][C _ 9]
16. [C 语言 回调函数 callback][C _ _ callback]
17. [C 语言 typedef][C _ typedef]
18. [C 语言 define 定义常量][C _ define]
19. [C 语言 define 防止头文件重复包含][C_C_ 1]

未经允许不得转载：[猿说编程][Link 3] » [C 语言 define 防止头文件重复包含][C_C_ 1]

[C_C_]: https://www.codersrc.com/c-c
[C]: https://www.codersrc.com/c%e8%af%ad%e8%a8%80%e5%9f%ba%e7%a1%80
[Link 1]: https://www.codersrc.com/archives/7426.html
[Link 2]: https://www.codersrc.com/archives/8738.html
[C_C_ 1]: https://www.codersrc.com/archives/8912.html
[Visual Studio _ Visual Assist]: https://www.codersrc.com/archives/7280.html
[Visual Studio]: https://www.codersrc.com/archives/8986.html
[C _]: https://www.codersrc.com/archives/8331.html
[C _ 1]: https://www.codersrc.com/archives/8349.html
[C _ _ p_ _ p]: https://www.codersrc.com/archives/8456.html
[C _ _p_p_p]: https://www.codersrc.com/archives/8520.html
[C _ 2]: https://www.codersrc.com/archives/8540.html
[C _ 3]: https://www.codersrc.com/archives/8564.html
[C _ 4]: https://www.codersrc.com/archives/8613.html
[C _ _ NULL]: https://www.codersrc.com/archives/8674.html
[C _ void]: https://www.codersrc.com/archives/8690.html
[C _ 5]: https://www.codersrc.com/archives/8700.html
[C _ 6]: https://www.codersrc.com/archives/8767.html
[C _ 7]: https://www.codersrc.com/archives/8780.html
[C _ 8]: https://www.codersrc.com/archives/8793.html
[C _ 9]: https://www.codersrc.com/archives/8809.html
[C _ _ callback]: https://www.codersrc.com/archives/8832.html
[C _ typedef]: https://www.codersrc.com/archives/8854.html
[C _ define]: https://www.codersrc.com/archives/8877.html
[Link 3]: https://www.codersrc.com