当前位置：文档之家 › c 编程规范

c 编程规范

  • 格式：docx
  • 大小：37.19 KB
  • 文档页数：2

c 编程规范

C 编程规范是用来规范 C 语言程序代码风格和编写规范的一系列准则。遵循 C 编程规范可以提高代码的可读性、可维护性，减少错误和 bug 的发生。以下是一些常见的 C 编程规范建议：

1. 代码缩进：缩进应该使用相同数量的空格符或制表符，一般为 4 个空格或一个制表符。缩进可以使代码结构更清晰，便于阅读。

2. 命名规范：变量、函数和常量的命名应该具有描述性，能够准确反映其用途和含义。使用驼峰命名法或下划线命名法是常见的命名风格。注意避免使用与 C 语言关键字相同的名称。

3. 注释规范：代码中应该包含必要的注释，用于解释代码的逻辑、实现细节和算法。注释应该清晰明了，不要出现拼写错误或过多的冗余信息。

4. 函数长度：函数的长度应该适中，不要过长。一般来说，一个函数应该只负责一个具体的功能，如果函数过长应该考虑分割成多个子函数。

5. 模块化设计：程序应该使用模块化的设计原则，将功能相似或相关的代码块组织成不同的模块或文件。这样可以提高代码的可维护性和可重用性。

6. 错误处理：程序应该正确处理各种可能发生的错误和异常情况。避免简单地使用错误代码或忽略错误，而是采取适当的错误处理措施，例如返回错误码或抛出异常。

7. 变量声明：变量应该在使用前先声明，并且尽量在被使用的代码块的起始处进行声明。声明时应给予适当的初始值，以避免使用未初始化的变量。

8. 代码复用：避免重复的代码和冗余的逻辑。可以通过编写可重用的函数、使用循环和条件语句等方式来提高代码的复用性和可读性。

9. 括号的使用：括号的使用是保证代码逻辑准确性的重要方式之一。建议在 if、for、while、switch 等语句块的使用中，使用括号来明确代码块的范围，以避免出现逻辑错误。

10. 代码格式：代码应该有一致的格式，用以增加可读性。应避免使用过长的代码行，一般建议每行代码长度不超过 80 个字符。

综上所述，C 编程规范是编写高质量、可维护代码的基本准则。遵循编程规范可以使代码更易读懂、易于理解、易于调试和维护。每个开发团队和个人都应该根据实际情况制定和遵守一套适合自己的编程规范。

合集下载

CC++编程规范

CC++编程规范

1. 文件结构

每个C++/C 程序通常分为两个文件。一个文件用于保存程序的声明（declaration），

称为头文件。另一个文件用于保存程序的实现（ implementation），称为定义（ definition）

C++/C 程序的头文件以“.h”为后缀，C 程序的定义文件以“. c”为后缀，C++程序

的定义文件通常以“.cpp”为后缀（也有一些系统以“.cc”或“.cxx”为后缀）。

1.1 版权和版本的声明

版权和版本的声明位于头文件和定义文件的开头（参见示例1-1），主要内容有：

（1）版权信息

（2）文件名称，标识符，摘要

（3）当前版本号，作者/修改者，完成日期

（4）版本历史信息

示例 1-1 版权和版本的声明

版本标识：采用 .. 来命名自己产品的编号。Linux 核心还有一个约定，

就是如果次版本号是偶数（如0、2、4 等），代表正式版本，如果次版本号是奇数(如1、3、5 等)，代

表的是开发过程中的测试版本。修订号则相当于 Build 号，用来标识一些小的改动。

1.2 头文件的结构

头文件由三部分内容组成：

1）头文件开头处的版权和版本声明（参见示例1-1）。

2）预处理块。

/*

* Copyright (c) 2003,北京梅梅出品有限公司

* All rights reserved.

*

* 文件名称：filename.h

* 文件标识：见配置管理计划书

* 摘要：简要描述本文件的内容

*/

#ifndef GRAPHICS_H // 防止graphics.h 被重复引用

#define GRAPHICS_H

下面其它的声明代码

………

下面是原作者、版本、完成、日期和当前版本的信息

/* 当前版本：1.1.2

* 作者：输入作者（或修改者）名字

* 完成日期：2003年5月20日

*

* 取代版本：1.1.1

* 原作者：输入原作者（或修改者）名字

* 完成日期：2003年4月10日

C语言代码规范(编程规范)

C语言代码规范(编程规范)

什么叫规范？在C语言中不遵守编译器的规定，编译器在编译时就会报错，这个规定叫作规则。但是有一种规定，它是一种人为的、约定成俗的，即使不按照那种规定也不会出错，这种规定就叫作规范。

虽然我们不按照规范也不会出错，但是那样代码写得就会很乱。大家刚开始学习C语言的时候，第一步不是说要把程序写正确，而是要写规范。因为如果你养成一种非常不好的写代码的习惯，代码就会写得乱七八糟，等到将来工作面试的时候，这样的习惯可能会让你失去机会。

代码如何写才能规范

那么代码如何写才能写得很规范呢？代码的规范化不是说看完本节内容后就能实现的。它里面细节很多，而且需要不停地写代码练习，不停地领悟，慢慢地才能掌握的一种编程习惯。所以大家不要想着一下子就能把代码规范化的所有知识全部掌握，也不要想着一下子就能把代码写规范，这是不太可能的。

有很多知识，比如为什么代码要这样写，为什么不能那样写，作为一个初学者你是很难弄明白的。有很多规范是为了在程序代码量很大的时候，便于自己阅读，也便于别人阅读。

所以刚开始的时候有很多规范你不知道为什么要那样规定，你就单纯地模仿就行了。等将来敲代码敲得时间长了，你就会感觉到那样写是很有好处的。

代码规范化的好处 代码规范化的第一个好处就是看着很整齐、很舒服。假如你现在用不规范的方式写了一万行代码，现在能看得懂，但等过了三个月你再回头看时就很吃力了，更不要说给别人看了。所以代码要写规范，比如加注释就是代码规范化的一个思想。

在一般情况下，根据软件工程的思想，我们的注释要占整个文档的20%以上。所以注释要写得很详细，而且格式要写得很规范。

第二个好处是，把代码写规范则程序不容易出错。如果按照不规范的格式输入代码的话，很容易出错。而代码写规范的话即使出错了查错也会很方便。格式虽然不会影响程序的功能，但会影响可读性。程序的格式追求清晰、美观，是程序风格的重要构成元素。

代码规范化的七大原则

代码规范化基本上有七大原则，体现在空行、空格、成对书写、缩进、对齐、代码行、注释七方面的书写规范上。

软件编程规范（MISRA_C）

软件编程规范（MISRA_C）

软件编程规范（MISRA_C）

软件编程规范

目录

一环境

二语言扩展

三文档

四字符集

五标识符

六类型

七常量

八声明与定义

九初始化

十数值类型转换

十一指针类型转换

十二表达式

十三控制语句表达式

十四控制流

十五 switch语句

十六函数

十七指针和数组

十八结构与联合

十九预处理指令

二十标准库

二十一运行时错误

一环境

规则1.1（强制）：所有代码都必须遵照ISO 9899:1990

“Programming languages - C”，由ISO/IEC 9899/COR1:1995，ISO/IEC 9899/AMD1:1995，和ISO/IEC9899/COR2:1996 修订。

规则1.2（强制）：不能有对未定义行为或未指定行为的依赖性。 这项规则要求任何对未定义行为或未指定行为的依赖，除非在其他规则中做了特殊说明，都应该避免。如果其他某项规则中声明了某个特殊行为，那么就只有这项特定规则在其需要时给出背离性。

规则1.3（强制）：多个编译器和/或语言只能在为语言/编译器/汇编器所适合的目标代码定义了通用接口标准时使用。

如果一个模块是以非C 语言实现的或是以不同的C 编译器编译的，那么必须要保证该模块能够正确地同其他模块集成。C 语言行为的某些特征依赖于编译器，于是这些行为必须能够为使用的编译器所理解。例如：栈的使用、参数的传递和数据值的存储方式（长度、排列、别名、覆盖，等等）。

规则1.4（强制）：编译器/链接器要确保31 个有效字符和大小写敏感能被外部标识符支持。

ISO 标准要求外部标识符的头6 个字符是截然不同的。然而由于大多数编译器/链接器允许至少31 个有效字符（如同内部标识符），因此对这样严格而并不具有帮助性的限制的适应性被认为是不必要的。

必须检查编译器/链接器具有这种特性，如果编译器/链接器不能满足这种限制，就使用编译器本身的约束。

规则1.5（建议）：浮点应用应该适应于已定义的浮点标准

软件编程规范(MISRA_C)

软件编程规范(MISRA_C)

1 软 件 编 程 规 范

目 录

一 环境

二 语言扩展

三 文档

四 字符集

五 标识符

六 类型

七 常量

八 声明与定义

九 初始化

十 数值类型转换

十一 指针类型转换

十二 表达式

十三 控制语句表达式

十四 控制流

十五 switch语句

十六 函数

十七 指针和数组

十八 结构与联合

十九 预处理指令

二十 标准库

二十一 运行时错误

2

一 环境

规则1.1（强制）： 所有代码都必须遵照ISO 9899:1990 “Programming languages - C”，由ISO/IEC 9899/COR1:1995，ISO/IEC 9899/AMD1:1995，和ISO/IEC9899/COR2:1996 修订。

规则1.2（强制）： 不能有对未定义行为或未指定行为的依赖性。

这项规则要求任何对未定义行为或未指定行为的依赖，除非在其他规则中做了特殊说明，都应该避免。如果其他某项规则中声明了某个特殊行为，那么就只有这项特定规则在其需要时给出背离性。

规则1.3（强制）： 多个编译器和/或语言只能在为语言/编译器/汇编器所适合的目标代码定义了通用接口标准时使用。

如果一个模块是以非C 语言实现的或是以不同的C 编译器编译的，那么必须要保证该模块能够正确地同其他模块集成。C 语言行为的某些特征依赖于编译器，于是这些行为必须能够为使用的编译器所理解。例如：栈的使用、参数的传递和数据值的存储方式（长度、排列、别名、覆盖，等等）。

规则1.4（强制）： 编译器/链接器要确保31 个有效字符和大小写敏感能被外部标识符支持。

ISO 标准要求外部标识符的头6 个字符是截然不同的。然而由于大多数编译器/链接器允许至少31 个有效字符（如同内部标识符），因此对这样严格而并不具有帮助性的限制的适应性被认为是不必要的 。