一、概述

比较著名的命名规则首推匈牙利命名法，这种命名方法是由Microsoft程序员查尔斯·西蒙尼(Charles Simonyi) 提出的。 其主要思想是“在变量和函数名中加入前缀以增进人们对程序的理解”。匈牙利命名法关键是：标识符的名字以一个或者多个小写字母开头作为前缀；前缀之后的是首字母大写的一个单词或多个单词组合，该单词要指明变量的用途。

[例如] lpszStr, 表示指向一个以'\\0'结尾的字符串（sz）的长指针（lp）变量。

骆驼（Camel）命名法近年来越来越流行，在许多新的函数库和Java这样的平台下使用得当相多。骆驼命名法，正如它的名称所表示的那样，指的是混合使用大小写字母来构成标识符的名字。其中第一个单词首字母小写，余下的单词首字母大写。

[例如] printEmployeePaychecks()，函数名中每一个逻辑断点都有一个大写字母来标记。

帕斯卡（Pascal）命名法与骆驼命名法类似。只不过骆驼命名法是第一个单词首字母小写，而帕斯卡命名法则是第一个单词首字母大写。

[例如] DisplayInfo()和UserName都是采用了帕斯卡命名法。

在C#中，以帕斯卡命名法和骆驼命名法居多。

事实上，很多程序设计者在实际命名时会将骆驼命名法和帕斯卡结合使用，例如变量名采用骆驼命名法，而函数采用帕斯卡命名法。

另一种流行的命名规则称为下划线命名法。

下划线法是随着C语言的出现流行起来的，在UNIX/LIUNX这样的环境，以及GNU代码中使用非常普遍。

1、常量名用大写，太长时用下划线隔开：

1.#define MAX

2.#define INCREMENT_SIZE

2、变量名采用小驼峰形式书写：

1.  int first

2.  float newElem

3、函数名、结构名和联合名采用大驼峰形式书写：

1.  void ClearList(List* L)

2.  {

3.      ….

4.  }

5.  int PutElem(int elem)

6.  {

7.      ….

8.  }

9.  typedef struct LinkNode

10. {

11.     int data;

12.     struct LinkNode* next;

13.  }*LinkPoint;

4、全局变量加前缀“g_”，其余特殊变量类似

本章所述的命名规则主要基于下划线命名法发展而来。

二、各类命名规则

1. 函数的命名

函数名使用下划线分割小写字母的方式命名：

设备名_操作名()

操作名一般采用：谓语（此时设备名作为宾语或者标明操作所属的模块）或者谓语+宾语/表语（此时设备名作为主语或者标明操作所属的模块） 等形式，如：

1.tic_init()

2.adc_is_busy()

3.uart_tx_char()

中断函数的命名直接使用 设备名_isr() 的形式命名，如：

1.timer2_isr()

2. 变量的命名

变量的命名也采用下划线分割小写字母的方式命名。命名应当准确，不引起歧义，且长度适中。如：

1.int length;

2.uint32 test_offset;

单字符的名字也是常用的，如i, j, k等，它们通常可用作函数内的局部变量。

◆tmp常用做临时变量名。

局部静态变量，应加s_词冠（表示static），如：

1.static int s_lastw; 

全局变量（尤其是供外部访问的全局变量），应加g_词冠（表示global），如：

1.void (*g_capture_hook)(void); 

3. 常量及宏的命名

采用下划线分割大写字母的方式命名，一般应以设备名作为前缀，防止模块间命名的重复。如：

1.#define TIMER0_MODE_RELOAD    2

2.#define TIMER2_COUNT_RETRIEVE(val)    ((uint16)(65535-(val)))

当然，看作接口的宏可以按照函数的命名方法命名，例如：

1.#define     timer2_clear()    (TF2 =0)

2.#define   timer0_is_expired() (TF0) 

4. 常用缩写词

原词        缩写

addition    add

answer        ans

array        arr

average        avg

buffer        buf或buff

capture        cap或capt

check        chk

count        cnt

column        col

control        ctrl

decode        dec

define        def

delete        del

destination    dst或dest

display        disp

division    div

encode        enc

environment    env

error        err

float        flt

frequency    freq

header        hdr

index        idx

image        img

increment    inc

initalize    init

iteration    itr

length        len

memory        mem

middle        mid

make        mk

message        msg

multiplication    mul

number        num

operand        opnd

optimization    opt

operator    optr

packet        pkt

positon        pos

previous    pre或prev

payload type    pt

pointer        ptr

return code    rc

record        rcd

receive        recv

result        res

return        ret

source        src

stack        stk

string        str

subtraction    sub

table        tab

temporary    tmp或temp

total        tot

time stamp    ts

value        val

5. 结语

没有一种命名规则可以让所有的程序员赞同。而这多种命名规则也确实各有利弊。

没有必要花太多的精力试图发明最好的命名规则，而是应当制定一种令大多数项目成员满意的命名规则并切实执行。标识符命名的一致性自然会体现出代码的优雅。

当然，如果你的程序使用了第三方的代码，而这些模块经验证确实是正确无误的。那么也没有必要一味追求命名的一致性，而去修改这些已经定型的模块中的函数和变量名。下载本文