C++代码书写规范——给新手程序员的一些建议

代码就是程序员的面子，不管是在工做中在电脑上写程序代码仍是在面试时在纸上写演示代码咱们都但愿写出整洁，优雅的代码。特别在工做中当咱们碰到须要维护别人的代码，或者是多人参与一个项目你们一块儿写代码的时候，若是碰到一些丑陋的代码，咱们还要看懂而且修改它的时候，那种难受，确定会让咱们回想起多年之前本身仍是新手程序员的时候，写下的那些丑陋的代码，而且深深内疚于将它们留给了咱们的后继者，不知道他们和它们是否还安好。因此，强调代码的规范性，写出整洁，优雅，可读性高的代码应该是成为一个合格的程序员的第一步。这里我就抛砖引玉，给你们一些关于C++代码规范性的一些建议。

1、关于添加空格和空行的一些建议

写代码的时候添加良好风格的空格和空行可使代码看上去更整洁，布局更清晰。

1.空格

• 建议一：函数名以后不要留空格，紧跟左括号‘ （’，以与关键字区别。
• 建议二：象 if、 for、 **while **等关键字以后应留一个空格再跟左括号‘ （’，以突出关键字。
• 建议三：‘，’以后要留空格。在for语句中的‘；’其后要留空格，如 for (i=0; i<5; i++)。
• 建议四：对于表达式比较长的 **for **语句和 **if **语句，为了紧凑起见能够适当地去掉一些空格。
• 建议五：赋值操做符、比较操做符、算术操做符、逻辑操做符、位域操做符，如“ =”、“ +=” “>=”、“ <=”、“ +”、“ *”、“ %”、“ &&”、“ <<”、 “ ^”等二元操做符的先后应当加空格。
• 建议六：一元操做符如“ !”、“ ~”、“ ++”、“ --”、“ &”（地址运算符）等先后不加空格。

下面这段代码就会显得不优雅，看着有些别扭。

//很差的风格
void func (int a,int b,int c,int d)
{
    if(a>=0)
    {
        if(a>=b&&c>=d)
        {
            int * x = & a; 
            ...//doSomeThing();
        }
    }
}

咱们但愿将它改成这样。

//良好的风格
void func(int a, int b, int c, int d)//建议一，建议三
{
    if (a >= 0)//建议二，建议五
    {
        if ((a>=b) && (c>=d))//建议四
        {
            int *x = &a; //建议六
            ...//doSomeThing();
        }
    }
}

还有这样的for语句for (i = 0; i < 5; i ++),就属于空格滥用了，应该改成for (i=0; i<5; i++)。

2.空行

• 建议一：在实现函数时，函数与函数之间应加空行。
• 建议二：在一个函数体内，逻揖上密切相关的语句之间不加空行，其它地方应加空行。

当程序中没有空行时是这样的。

void func1()
{
    while (condition)
    {
        ...//doSomeThing();
        if (condition)
        {
            ...//doSomeThingRelated();
        }
        else
        {
            ...//doSomeThingRelated();
        }
        ...//doSomeThing();
    }
}
void func2()
{
    ...//doSomeThing();
}

而良好的空行不紧能使代码看上去更整洁，代码逻辑也会更清晰。

//良好的风格
void func1()
{
    while (condition)
    {
        ...//doSomeThing();

        if (condition)
        {
            ...//doSomeThingRelated();
        }
        else
        {
            ...//doSomeThingRelated();
        }

        ...//doSomeThing();
    }
}

void func2()
{
    ...//doSomeThing();
}

2、关于代码行格式的一些建议

• 建议一：一行代码只作一件事情。
• 建议二：长表达式要在低优先级操做符处拆分红新行，操做符放在新行之首 （以便突出操做符）。拆分出的新行要进行适当的缩进，使排版整齐，语句可读。

//很差的风格
void func()
{
    int veryVeryLongWidth, veryVeryLongHeight;
    if ((veryVeryLongWidth > veryVeryLongHeight) || (veryVeryLongWidth < veryVeryLongHeight))doSomeThing();
}

过长的代码行不管是书写仍是阅读对人来讲都不是一个美好的体验，因此咱们建议以上代码要这样写。

//良好的风格
void func()
{
    int veryVeryLongWidth; 
    int veryVeryLongHeight;
    if ((veryVeryLongWidth > veryVeryLongHeight)
      || (veryVeryLongWidth < veryVeryLongHeight))
    {
        doSomeThing();
    }
}

3、关于命名的一些建议

• 建议一：变量，函数，文件命名应该具备描述性，最好采用英文单词或其组合（不要使用拼音，或者无心义的abc之类的，除了像for (i=0; i<5; i++)中的i这样的），以便记忆和阅读。
• 建议二：类名和函数名用大写字母开头的单词组合而成。
  例如：

class Book; 
class ReadBook; 
void Draw(); 
void DrawImage();

• 建议三：变量和参数用小写字母开头的单词组合而成。
  例如：

int value;
void SetValueMode(int valueMode);

• 建议四：常量全用大写的字母，用下划线分割单词。
  例如：

const int MAX = 100;
const int MAX_LENGTH = 100;

• 建议五：全局变量加前缀 g_（表示 global）。静态变量加前缀 s_（表示 static）。类的成员变量加前缀 m_（表示 member）。
  例如：

int g_maxValue;
static int s_maxValue;   
void Object::SetValue(int maxValue)
{
    m_maxValue = maxValue;
}

4、关于添加注释的一些建议

在C++中注释主要有两种，程序块的注释常采用“ /*…*/”，行注释通常采用“ //…”。注释主要用在3个地方。一、版权申明，二、函数说明，三、重要或复杂代码提示。对于前两种，每一个人或者每一个公司都有我的的规范和习惯，这里只要你们在公司内部统一便可。关于第三种给重要或复杂代码添加提示，咱们有一下几点建议。

• 建议一：注释的确很重要，可是最好的代码自己就是文档（self-document），类型和变量命名意义明确要比经过注释解释模糊命名好得多。
• 建议二：边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。再也不有用的注释要记得删除。
• 建议三：注释的位置应与被描述的代码相邻，能够放在代码的上方或右方，不可放在下方。

5、关于类中成员声明次序的一些建议

• 建议一：在类中按照public:、protect:、private:的次序声明。若是那一块没有直接忽略。
• 建议二：在同一块中按照一、结构体和枚举，二、常量，三、构造函数，四、析构函数，五、成员函数，六、成员变量的次序声明。

6、关于if语句中的变量“与零值比较”的一些建议

• 建议一：不可将布尔变量直接与 TRUE、 **FALSE **或者 1、 **0 **进行比较。
  假设布尔变量名字为 flag，它与零值比较的标准 if 语句以下：

if (flag) // 表示 flag 为真
if (!flag) // 表示 flag 为假

• 建议二：应当将整型变量用“ ==”或“！=”直接与 0 比较。
  假设整型变量的名字为 value，它与零值比较的标准 if 语句以下：

if (value == 0)
if (value != 0)

也能够将0放在比较运算符前面。

if (0 == value)
if (0 != value)

这时若是将“==”写成“=”，编译器会报错。

• 建议三：不可将浮点变量用“ ==”或“！=”与任何数字比较。不管是 float 仍是 double 类型的变量，都有精度限制。因此必定要避免将浮点变量用“ ==”或“！=”与数字比较，应该设法转化成“ >=”或“ <=”形式。
  假设浮点变量的名字为 x，应当将

if (x == 0.0) // 隐含错误的比较

修改成

const float EPSINON = 0.00001;
if ((x>=-EPSINON) && (x<=EPSINON))

其中 EPSINON 是容许的偏差（即精度）。

• 建议四：应当将指针变量用“ ==”或“！ =”与** NULL **比较。
  假设指针变量的名字为 p，它与零值比较的标准 if 语句以下：

if (p == NULL) // p 与 NULL 显式比较，强调 p 是指针变量
if (p != NULL)

做者：吴尼玛cs 连接：https://www.jianshu.com/p/ccc1b1992894 来源：简书 简书著做权归做者全部，任何形式的转载都请联系做者得到受权并注明出处。