c语言代码编写的格式？

C语言 程序代码编写规范

（初级程序员 讨论版）

前言

一个好的程序编写规范是编写高质量程序的保证。清晰、规范的源程序不仅仅是方便阅读，更重要的是能够便于检查错误，提高调试效率，从而最终保证软件的质量和可维护性。

说明

l 本文档主要适用于刚刚开始接触编程的初学者。

l 对于具有一定工程项目开发经验的程序员，建议学习C语言程序代码编写规范—高级版。

目录

1 代码书写规范

2 注释书写规范

3 命名规范

4 其它一些小技巧和要求

1 代码书写规范

1.1函数定义

花括号： { }

每个函数的定义和说明应该从第1列开始书写。函数名（包括参数表）和函数体的花括号应该各占一行。在函数体结尾的括号后面可以加上注释，注释中应该包括函数名，这样比较方便进行括号配对检查，也可以清晰地看出来函数是否结束。

范例1：函数的声明

void matMyFunction(int n)

{

……

} /* matMyFunction*/

1.2空格与空行的使用

要加空格的场合

l 在逗号后面和语句中间的分号后面加空格，如：

int i, j, k

for (i = 0i <ni++)

result = func(a, b, c)

l 在二目运算符的两边各留一个空格，如

a >ba <= b i = 0

l 关键字两侧，如if () …, 不要写成if() …

l 类型与指针说明符之间一定要加空格：

char *szName

不加空格的场合

l 在结构成员引用符号.和->左右两加不加空格：

pStud->szName, Student.nID

l 不在行尾添加空格或Tab

l 函数名与左括号之间不加空格:

func(…)

l 指针说明符号*与变量名间不要加空格:

int *pInt不要写成: int * pInt

l 复合运算符中间不能加空格，否则会产生语法错误，如：

a + = b a <= b都是错误的

空行与换行

l 函数的变量说明与执行语句之间加上空行

l 每个函数内的主要功能块之间加空行表示区隔

l 不要在一行中写多条语句.

范例2：空行与换行

int main()

{

int i, j, nSum = 0 //变量说明

for (i = 0i <10i++) //执行代码

{

for (j = 0j <10j++)

{

nSum += i

}

}

}

1.3缩进的设置

根据语句间的层次关系采用缩进格式书写程序，每进一层，往后缩进一层

有两种缩进方式：1，使用Tab键；2，采用4个空格。

整个文件内部应该统一，不要混用Tab键和4个空格，因为不同的编辑器对Tab键的处理方法不同。

1.4折行的使用

· 每行的长度不要超过80个字符，当程序行太长时，应该分行书写。

· 当需要把一个程序行的内容分成几行写时， *** 作符号应该放在行末。

· 分行时应该按照自然的逻辑关系进行，例如：不要把一个简单的逻辑判断写在两行上。

· 分行后的缩进应该按照程序的逻辑关系进行对齐。例如：参数表折行后，下面的行应该在参数表左括号的下方。

范例2：折行的格式

dwNewShape = matAffineTransform(coords, translation,

rotation)

if (((new_shape.x >left_border) &&

(new_shape.x <right_border)) &&

((new_shape.y >bottom_border) &&

(new_shape.y <top_border)))

{

draw(new_shape)

}

1.5嵌套语句（语句块）的格式

对于嵌套式的语句--即语句块（如，if、while、for、switch等）应该包括在花括号中。花括号的左括号应该单独占一行，并与关键字对齐。建议即使语句块中只有一条语句，也应该使用花括号包括，这样可以使程序结构更清晰，也可以避免出错。建议对比较长的块，在末尾的花括号后加上注释以表明该语言块结束。

范例3：嵌套语句格式

if (value <max)

{

if (value != 0)

{

func(value)

}

}

} else {

error("The value is too big.")

} /* if (value <max) */

2 注释书写规范

注释必须做到清晰，准确地描述内容。对于程序中复杂的部分必须有注释加以说明。注释量要适中，过多或过少都易导致阅读困难。

2.1注释风格

· C语言中使用一组（/* … */）作为注释界定符。

· 注释内容尽量用英语方式表述。

· 注释的基本样式参考范例4。

· 注释应该出现在要说明的内容之前，而不应该出现在其后。

· 除了说明变量的用途和语言块末尾使用的注释，尽量不使用行末的注释方式。

范例4：几种注释样式

/*

* ************************************************

* 强调注释

* ************************************************

*/

/*

* 块注释

*/

/* 单行注释 */

//单行注释

int i/*行末注释*/

2.2何时需要注释

· 如果变量的名字不能完全说明其用途，应该使用注释加以说明。

· 如果为了提高性能而使某些代码变得难懂，应该使用注释加以说明。

· 对于一个比较长的程序段落，应该加注释予以说明。如果设计文档中有流程图，则程序中对应的位置应该加注释予以说明。

· 如果程序中使用了某个复杂的算法，建议注明其出处。

· 如果在调试中发现某段落容易出现错误，应该注明。

3 命名规范

3.1常量、变量命名

l 符号常量的命名用大写字母表示。如：

#define LENGTH 10

l 如果符号常量由多个单词构成，两个不同的单词之间可以用下划线连接。如：

#define MAX_LEN 50

变量命名的基本原则：

l 可以选择有意义的英文（小写字母）组成变量名，使人看到该变量就能大致清楚其含义。

l 不要使用人名、地名和汉语拼音。

l 如果使用缩写，应该使用那些约定俗成的，而不是自己编造的。

l 多个单词组成的变量名，除第一个单词外的其他单词首字母应该大写。如：

dwUserInputValue。

3.2函数命名

函数命名原则与变量命名原则基本相同。对于初学者，函数命名可以采用“FunctionName”的形式。

4 其它一些小技巧和要求

l 函数一般情况下应该少于100行

l 函数定义一定要包含返回类型，没有返回类型加void

l 写比较表达式时，将常量放在左边

10 == n

NULL != pInt

l 指针变量总是要初始或重置为NULL

l 使用{}包含复合语句，即使是只有一行，如：

if (1 == a)

{

x = 5

}

http://home.ustc.edu.cn/~danewang/c/CodingStandards.html

在进行C语言编写程序时，需要注意以下几点：

1. 编写规范：要遵守C语言的编程规范，如变量命名规范、缩进、注释等。编写规范的代码易于维护和理解，且可以提高代码质量。

2. 内存管理：C语言中需要手动管理内存，包括内存分配、释放等。要注意内存泄漏和指针错误等问题，避免程序崩溃或数据损坏等情况。

3. 安全性：C语言对数据的边界检查并不严格，容易受到缓冲区溢出等安全问题的攻击。在编写程序时需要考虑安全性，包括输入的数据验证、防范攻击等。

4. 错误处理：C语言中需要处理各种可能出现的错误，包括语法错误、运行时错误、编译错误等。需要使用错误处理机制来处理这些错误，保证程序运行的稳定性和安全性。

5. 代码复用性：C语言中可以使用函数和模块化的方式来提高代码的复用性。需要把相关的功能封装成函数或模块，以便在程序的不同部分进行重用，提高代码效率和可维护性。

除此之外，还需要注意代码的可读性和可维护性。编写清晰易懂的代码，遵守编程规范，注重代码注释，是提高代码可读性和可维护性的有效方法。

书写C语言程序时应遵循的规则 ！

从书写清晰，便于阅读，理解，维护的角度出发，在书写程序时 应遵循以下规则：

1.一个说明或一个语句占一行。

2.用{} 括起来的部分，通常表示了程序的某一层次结构。{}一般与该结构语句的第一个字母对齐，并单独占一行。

3.低一层次的语句或说明可比高一层次的语句或说明缩进若干格后书写。以便看起来更加清晰，增加程序的可读性。在编程时应力求遵循这些规则，以养成良好的编程风格。

C语言是一门功能强大的编程语言，它也是C++语言的基础。C语言属于中级语言。这里所说的中级是相对于计算机的底层硬件而言的。汇编语言是最低级的语言，它可以直接与硬件打交道。高级语言有Pascal、Basic、Fortran等等。高级语言的一条语句对应低级语言的很多条语句，任何高级语言编写的程序都要经过编译程序的编译、连接才能成为可以运行的程序。编译连接的过程也就是把高级语言翻译成机器语言(二进制机器码)的过程，而汇编语言是基本上与机器语言一 一对应的一种语言。这个翻译过程是由编译程序自动完成的。把C语言定为中级语言是有它的道理的，因为C语言既有汇编语言的存取底层硬件的能力，又具有高级语言的许多特点。熟练掌握了C语言，学习其它的各种编程语言应该是很轻松的了。

C语言的书写格式：

1) 一个C语言编写的源程序，必定有一个主程序(称为main()函数，在C语言中子程序称为“函数”(当然，不要理解成为数学里面的“函数”)。但是决不能有一个以上的main函数(即只能有一个)。

2) 函数语句块用‘{’括号开始， 以‘}’反括号结束。这样的花括号必须成对出现。

3) 表达式写在小括号里面，以‘(’括号开始，以‘)’反括号结束。

4) 函数不能嵌套，即函数里面不能再套函数。(每一个函数是完成一个特定功能的函数模块)

C语言的组成：

C语言是由许多函数组成的。其中只有一个主函数(main()函数)。C程序执行时总是从main函数的‘{’处开始，至main函数的反大括号'}'处结束。当然还有其它一些规则，这将在以后的学习中去熟悉它。

C语言的书写规则：

C语言在书写时有它自身的特点：书写格式比较自由，在一行里可以写多条语句，一个语句也可以分写在多行上。虽然如此，在书写源程序时还是要注意哪些可以自由书写，而哪些必须要按照书写规则来书写。

几条规则写在下面：

1) 一行内可以写几个语句，建议一行不超过两条语句；

2) 一条语句可以写在多行上；

3) C语句不需要写行标号；

4) 每条语句及数据定义的后面要写上分号以表示该语句结束；

5) C语言中注释用 /* */来表示；

6) 建议书写时采用缩进格式；

7) 花括号、小括号都是成对出现的。

一个最简单的C程序的编写：

/* 程序代码*/ /* 注释部分*/

main() /*main是主函数名。紧跟在main后面的括号是放参数的。

括号里面为空说明main函数不需要参数*/

{ /*正写的大花括号表示main函数从这里开始*/

} /*反写的大花括号表示main函数到这里结束*/

说明：由于是一个演示程序，在函数体内并没有任何可以执行的语句，也就是这个程序什么事也不做。

这个程序就是这么简单： 写在一行上就是 main() { }

你在TC的编辑环境下把这段代码输入进去，按F9键编译连接，按CTRL_F5运行，一定很正常。但是什么结果也不会有，因为在main函数里面什么代码也没有。

下面再举一个可以向屏幕上输出一条信息的例子：

main()

{

printf("这就是C语言编写的程序!")/*这一条语句的作用是向屏幕输出一条信息

”这就是C语言编写的程序!"*/

}

在这个程序中，main函数只有一条语句：printf("这就是C语言编写的程序!")这个语句的作用是向屏幕输出一个字符串。有关这个语句的知识以后再讲。现在要注意的是一个C语言程序的框架是怎样组成的。

C语言程序的几种文件格式：

1、 源程序---在TC集成环境中输入的程序文本称为源程序。源程序是一种文本文件。它是我们看得见并认识的一种文件。其扩展名为.C。例如你把文件保存为TEST，那么在磁盘上应看得到TEST.C这个文件。这样的文件可以用记事本打开。

2、二进制文件---写完了源程序后接着要做的是编译这个文件。在TC集成环境里是按ALT_F9键，编译后生成了一个二进制文件，这个二进制文件名为TEST.OBJ，也就是扩展名为OBJ的目标文件。

3、运行文件---最后一步是make(或Link)，在TC集成环境里是按F9键Make之后生成了一个可以在DOS下运行的文件，其扩展名为EXE。如TEST.EXE。这个EXE文件是由第2步中的OBJ文件生成的。OBJ文件虽然是二进制文件，而电脑又是可以运行二进制文件的，为什么还要把OBJ文件Link为EXE文件才能运行？这里的知识就比较多了，这里不能多讲。但是要明白一点，在DOS下仅仅有了一个二进制文件还不能运行，因为 *** 作系统要把这些二进制文件加以规划，把相应的数据、程序代码放到应该放的内存位置，这样的经过严密规划和组织好了的二进制文件才能运行。而这些只有在生成的EXE文件里面才做完了这些工作。

---