嵌入式C编码文件头申明规范

编码规范

2.1 文件头申明

◎ 新增.c必须添加注释，标注公司名称、文件功能说明，创建日期、作者，后续修改说明 范例如下：

/*********************************************************************     
* Copyright (c)  Hehe,Ltd. All rights reserved.
* Description:用于详细说明此程序文件完成的主要功能，
*             与其他模块或函数的接口依赖等关系           
*
* History:修改历史记录列表，包括修改日期、修改者及修改内容简述                    
* Date               Author                Modification:                                                                     
* 2023-11-25        embedded-system        create v1.0
*********************************************************************/

可配置Source Insight 自动生成模板。

2.2 文件

◎ 所有.h头文件必须采取阻止内容被包含多于一次的机制

#ifndef __XXX__
#define __XXX__
#endif  /*__XXX__*/

◎ 头文件对外接口，应放置对外部的声明，如对外提供的函数声明、宏定义、类型定义等。
◎ 内部使用的函数声明不应放在头文件中。
◎ 内部使用的宏、枚举、结构定义不应放入头文件中。
◎ 变量定义禁止在头文件中，应放在.c文件中。
◎ 模块内使用的全局变量，不应通过在头文件中声明的方式直接暴露给外部。
◎ 头文件中只包含接口的声明，不含实现。
◎ 头文件应当职责单一，头文件过于复杂，依赖过于复杂是导致编译时间过长的主要原因。
◎ 每一个.c文件应有一个同名.h文件，用于声明需要对外公开的接口。
◎ 禁止头文件循环依赖,禁止包含用不到的头文件。
◎ 每个.c源文件内容片段按如下顺序，文件注释-包含头文件-宏定义-数据结构定义-变量定义-引用外部变量-引用外部函数-本地函数-全局函数。