/************************************************************************************************** Company Name* Address** (c) Copyright 19xx, Company Name, City, State* All Rights Reserved*** Filename :* Programmer(s):* Description :*************************************************************************************************//*$PAGE*/
二、包含文件
#include包含通常有两种方式，在源文件中包含所需的头文件，还有一种把所有头文件都整理在一个文件，比如INCLUDES.H。这样你就不必记住哪个头文件与哪个源文件一起使用，尤其是在添加新模块时。唯一的不便是编译每个文件需要更长的时间。
/************************************************************************************************** INCLUDE FILES*************************************************************************************************/#include "INCLUDES.H"/*$PAGE*/
三、命名标识符
符合ANSI C标准的C编译器（到目前为止，大多数C编译器都这样做）最多允许32个字符作为标识符名称。标识符是变量、结构/联合成员、函数、宏、＃defines等。
比如：大写字符用于分隔标识符中的单词，功能和下划线字符（_）类似。
static INT16U KeyCharCnt; /* Number of keys pressed */static char KeyInBuf[100]; /* Storage buffer to hold chars */ char KeyInChar; /* Character typed *//*$PAGE*/ µC/OS命名标识符：
函数声明中的形式参数应仅包含小写字符。
自动变量名称应仅包含小写字符。
静态变量和函数应使用文件/模块名称（或其一部分）作为前缀，并应使用大写/小写字符。
extern变量和函数应使用文件/模块名称（或其一部分）作为前缀，并应使用大写/小写字符。
四、缩略
代码基本都会使用缩写，缩写不能中英文混合，通常是英文的缩写，比如OS代表Operating System。
一些常用的缩写需要统一规范，一些不常用的缩写需要在代码中注释清除。 µC/OS代码中使用的缩写比较多，比如：
| 缩写 | 原意 |
| Addr | Address |
| Blk | Block |
| Chk | Check |
| Clr | Clear |
| Cnt | Count |
| CPU | Central Processing Unit |
| Ctr | Counter |
| Ctx | Context |
| Cur | Current |
| Del | Delete |
| Dly | Delay |
| Err | Error |
五、注释
// /* */ 是两种最常见注释的方法，还有注释的位置也很关键。通常在代码所在行上一行，或者在代码所在行（代码后面）。 但也有奇葩把代码注释在代码所在行的下一行（通常不建议这么操作）。
µC/OS使用 /**/ 而且都在代码所在行（后面）：
int atoi (char *s){ int n; /* Partial result of conversion */ n = 0; /* Initialize result */ while (*s >= '0' && *s <= '9' && *s) { /* For all valid characters and not end of string */ n = 10 * n + *s - '0'; /* Convert char to int and add to partial result */ s++; /* Position on next character to convert */ } return (n); /* Return the result of the converted string */} 六、#defines
头文件（.H）和C源文件（.C）可能需要定义常量和宏，常量和宏始终使用大写字母。
#define KEY_FF 0x0F#define KEY_CR 0x0D#define KEY_BUF_FULL() (KeyNRd > 0)
C语言允许你使用typedef关键字创建新的数据类型，µC/OS使用大写字符声明所有数据类型，因此遵循用于常量和宏的相同规则，永远不会混淆常量，宏和数据类型的问题。
typedef unsigned char BOOLEAN; /* Boolean */typedef unsigned char INT8U; /* 8 bit unsigned */typedef char INT8S; /* 8 bit signed */typedef unsigned int INT16U; /* 16 bit unsigned */typedef int INT16S; /* 16 bit signed */typedef unsigned long INT32U; /* 32 bit unsigned */typedef long INT32S; /* 32 bit signed */typedef float FP; /* Floating Point */
八、局部变量
一些源模块要求使用局部变量，通过使用static关键字，变量可以按字母顺序或功能顺序列出。
static char KeyBuf[100];static INT16S KeyNRd;
九、缩进
缩进有使用空格和Tab两种符号，规范通常只使用一种，不能空格和Tab两种混合使用（现在很多编辑器都支持Tab替换成空格的功能）。
如果混合使用，在不同编辑器打开代码，你就可能会看到一团糟。
µC/OS使用四个空格：
if (x < 0) z = 25;if (y > 2) { z = 10; x = 100; p++;}
十、结构体和联合体
包含结构体和联合体的格式、命名、注释等这些都需要规范，µC/OS代码使用的比较简单，也是大众化的定义：
typedef struct line { /* Structure that defines a LINE */ int LineStartX; /* 'X' & 'Y' starting coordinate */ int LineStartY; int LineEndX; /* 'X' & 'Y' ending coordinate */ int LineEndY; int LineColor; /* Color of line to draw */} LINE;typedef struct point { /* Structure that defines a POINT */ int PointPosX; /* 'X' & 'Y' coordinate of point */ int PointPosY; int PointColor; /* Color of point */} POINT;
本文就写到这里，代码规范建议参考一些大厂的规范手册。当然，每家公司的代码规范可能有所不同，只要写代码是时统一就行。 
下一主题
