如何制定有效的命名规范以增强代码的可读性与维护性?

当然,请提供您需要我根据内容生成回答的具体内容,无论是问题、主题还是任何其他信息。一旦收到您的详细说明,我将很乐意为您生成一段符合要求的回答。如果您是希望了解命名建议或命名规范的相关内容,也请进一步明确,以便我能提供准确的帮助。

1、匈牙利命名法

如何制定有效的命名规范以增强代码的可读性与维护性?

|定义 |特点 |示例 |

| | | |

| 匈牙利命名法是一种早期的命名规范,由微软的一个匈牙利人发明,该规范要求前缀字母用变量类型的缩写,其余部分用变量的英文或英文的缩写,单词第一个字母大写。int iMyAge;char cMyName[10];float fManHeight;

2、驼峰式命名法

|定义 |特点 |示例 |

| | | |

| 驼峰式命名法包括小驼峰式和大驼峰式(帕斯卡命名法),小驼峰式要求第一个单词首字母小写,后面其他单词首字母大写;大驼峰式要求每个单词的第一个字母都要大写。int myAge;char myName[10];float manHeight;

3、下划线命名法

|定义 |特点 |示例 |

| | | |

| 下划线命名法通过下划线来分割全部都是大写的单词,尤其在宏定义和常量中使用较多。int my_age;char my_name[10];float man_height;

4、通用命名规则

|定义 |特点 |示例 |

| | | |

| 描述性命名,少用缩写,函数、变量、文件名要有描述性,尽量使用描述性的命名,避免只有项目开发者能理解的缩写。bsp_i2c.hbsp_i2c.c

5、类型命名

|定义 |特点 |示例 |

| | | |

| 类型名称的每个单词首字母均大写,不包含下划线,所有类型命名(类、结构体、类型定义、枚举、类型模板参数)均使用相同约定。MyExcitingClassMyExcitingEnum

6、变量命名

|定义 |特点 |示例 |

| | | |

| 变量名一律小写,单词之间用下划线连接,类的成员变量以下划线结尾,但结构体的不用。a_local_variablea_struct_data_membera_class_data_member_

7、文件命名

|定义 |特点 |示例 |

| | | |

| 文件名尽量全部小写,可以包含下划线或连字符,依照项目的约定。bsp_i2c.cbspi2c.c

8、路径命名规则

|定义 |特点 |示例 |

| | | |

| 全部采用小写代码,使用名词,不适用动词。data/datasets/rawmodels/trained_models

9、高可读命名规范

|定义 |特点 |示例 |

| | | |

| 提高代码的可读性,命名应具有描述性,避免模糊不清的命名。daysSinceModificationisFileChanged

10、重构原则

|定义 |特点 |示例 |

| | | |

| 全局修改所有引用处,避免有全局变量的影响,每一处小小的优化都是对代码质量的提升,将不规范的命名修改为规范的命名。

FAQs

1、为什么需要重视命名?

原因:好的命名即是注释,别人一看到你的命名就知道你的变量、方法或者类是做什么的,这样可以减少不必要的注释,提高代码的可读性和可维护性

2、常见的命名规范有哪些?

匈牙利命名法:前缀字母表示变量类型,其余部分用变量的英文或英文缩写,单词第一个字母大写。

驼峰式命名法:包括小驼峰式和大驼峰式(帕斯卡命名法),前者第一个单词首字母小写,后者每个单词的第一个字母都要大写。

下划线命名法:通过下划线来分割全部都是大写的单词,尤其在宏定义和常量中使用较多。

通用命名规则:描述性命名,少用缩写,函数、变量、文件名要有描述性。

类型命名:类型名称的每个单词首字母均大写,不包含下划线。

变量命名:变量名一律小写,单词之间用下划线连接,类的成员变量以下划线结尾,但结构体的不用。

文件命名:文件名尽量全部小写,可以包含下划线或连字符,依照项目的约定。

路径命名规则:全部采用小写代码,使用名词,不适用动词。

高可读命名规范:提高代码的可读性,命名应具有描述性,避免模糊不清的命名。

重构原则:全局修改所有引用处,避免有全局变量的影响,每一处小小的优化都是对代码质量的提升。

原创文章,作者:未希,如若转载,请注明出处:https://www.kdun.com/ask/1112825.html

本网站发布或转载的文章及图片均来自网络,其原创性以及文中表达的观点和判断不代表本网站。如有问题,请联系客服处理。

(0)
未希新媒体运营
上一篇 2024-10-01
下一篇 2024-10-01

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注

产品购买 QQ咨询 微信咨询 SEO优化
分享本页
返回顶部
云产品限时秒杀。精选云产品高防服务器,20M大带宽限量抢购 >>点击进入