代码编写注意事项

如何写出好代码,这个是一个值得考虑的问题。怎样才能写出即可读又高效的代码呢? 本文从编
码的细微处入手,总结如何写出质量高的代码。本文的观点只是一家一言,欢迎大家一起讨论。
高质量的代码一定是可读性高的,如何让代码可读性高
一) 代码文件位置
好的代码要先找对代码的存放位置,比如inc就要放头文件,src就要存放源代码文件。不要A功

能的目录存放了B功能的文件。
二) 命名
这个命名包含 文件夹命名、代码文件命名、函数命名、变量命名。
常见的命名方式有驼峰,有划线方式,匈牙利命名法、帕斯卡(pascal)命名法,如何选择:
1)如果是基于现有代码开发的话,现有什么命名方式那么就要用什么命名方式
2)如果是从无到有的新项目,那么使用什么语言,就采用该语言的常用命名方式,比如C语言,

一般使用下划线命名方式多一点。Java采用帕斯卡(pascal)命名法多一些。
还有全局变量和局部变量的命名,全局一般使用大写方式,局部的话使用小写
函数的命名,有的语言使用__下表示内部函数,C/Python都有这种应用
像 i j k这样的一般都是在循环中,ret表示返回值,这些都是约定俗成的规则。
三)函数
one function do one thing,尽量将一个功能封装成一个函数,函数能复用就复用。
函数返回值要有意义,C语言一般0表示返回成功,负数表示返回fail,每个返回值要有明确意义

这样的话便于调用者判断。
四) 格式
比如从C的经验上来,单行不能超过80个字符。TAB空格不能混用,推荐使用空格,至于空2格还是

空4格视环境和语言而定。
五) debug Log信息
好多人喜欢将debug信息放到代码中。建议将error log保留,debug log设置成可开启方式,默认

关闭,比如通过配置log等级参数方式。这种一般适合底层开发
比如在上层的开发中,往往需要一些运行信息以便检测运行状态,这种的话保留info信息,debug

信息的话在正式发布是要关闭。
六) 编译的一致性
代码最好要对编译保持一致性,这样保证在代码未修改时,每次编译得到的行为都是相同的。保持

编译的一致性,像DATE, TIME这些干扰编译结果的尽量不用。
七)尽可能代码复用
比如如果语言有相关库函数实现的话,不要自己造结构体,简单的原因是库中的代码质量是保证

的,自己实现的话bug的几率会高。
比如语言中已经实现了List vector hashmap等,不要自己重复造轮子。
八) 设计模式使用
对于面向对象的开发,能使用成熟的设计模式尽量使用成熟的设计模式,这样易于后期扩展。
九) 注释
最好的代码就是注释,如果代码不能很好的解释的话,那么就要添加注释。
对于那些注释可以用,那些不能用,可以参考谷歌的一片文章

https://testing.googleblog.com/2017/07/code-health-to-comment-or-not-to-comment.html
十) 代码执行效率考虑
虽然当前CPU的性能越来越好,但是对于编码过程中适当的效率考虑也是必要的。
十一) 逻辑简单
不要嵌套好多if else,尽量简化逻辑清晰,便于维护。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,189评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,577评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,857评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,703评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,705评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,620评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,995评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,656评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,898评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,639评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,720评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,395评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,982评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,953评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,195评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,907评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,472评论 2 342