代码不规范?985,211也不要!

安富莱与正点原子的编码规范 安富莱编码规范与正点原子编码规范 立即下载

为什么写代码要规范?可以说代码是程序员的第二张脸

场景:

要讨论这个问题,我们首先得说点其他的。我们来假设一个场景:相信每个朋友最开始都有这种感受:哇,今天状态超好,简直是文若铅华,丝若泉涌。敲起键盘来简直感觉不要太顺畅。随着一连串的编写,可能写完抬头一看一上午或者一下午就过去了。要么是饭点,要么就该要下班了。在想一想自己今天的状态,那感觉不要太好。然后高高兴兴就回家或者吃饭去了。之前的事情告一段落。。。。。。。然后时间慢慢过去.....

问题来了:

3个月后,项目经理在团队里面问道,之前的这个项目是谁负责的来着,然后顺利的找到你,现在客户有一些新的需求,既然之前是你写的,那么你来改一下吧。。。

想着也确实是自己写的,也没有多大问题,稍微看下改了就是,于是乎痛苦的事情来了。下载了自己当初写的源码,打开一看,API注释没有写全,代码注释基本没有,当时的变量取名也比较随心,是什么意思来着。。。。。。当初怎么想的,在大量的工作堆积下早已想不起来。花了半天时间看代码,越看脸越黑,我相信此时这个代码要是不是自己写的,恐怕就已经要骂人了。

怎么解决:

那么此时的你改怎么办呢,如果这是一个小项目,只有几千行源码,也许你会觉得重写一遍远比去理解当初的意思来的更快,然而,如果这是一个大项目呢,涉及的代码量可能有几万行的时候怎么办?毫无办法,只能一步一步去尝试理解,然后重新添加注释,你会发现这需要花的时间成本太高了 ,长时间的加班就显得不可避免,还会给领导落下个工作效率低下的映像。这都不是你所想要看到的结果。

实际案例:

在前不久,我们团队接到一个项目,粗略的看了一下,源码大概在1.3W+的样子,

简单的通过公司的质量检测工具做了份质量评估报告:

  API注释率35%;

  代码注释覆盖率10%;

  不符合编码规范问题1W+;

  存在严重阻断100+;

拿到这个质量检测报告我的内心是崩溃的,这等于这项目的源码基本是看不了的。尝试去阅读理解然后对其进行维护的可能性基本等于零。

这使得我们不得不思考重写整个项目的可能性,在用了大半个月的时间做可行性分析(包括原维护部门的人员交流,原开发部门的文档补全,测试部门的测试用例。。等等)之后,我们得到了可以重写的结论。接下来就是对新环境的搭建,新测试用例的搬迁,新单元源码的重写。。。。为此又付出的4个月左右的时间。前前后后加起来就是小半年。而这些时间本身是有必要付出的吗?答案当然是否定的。

即使明白代码规范的好处,但是有的迫于项目压力,有的因为繁琐的规范作出很多额外的工作,更有的不重视维护的问题,而很难贯彻代码规范。

那么,我们需要了解,规范开发最大的受益人其实是自己!

你有没有花费很多的时候查找自己的代码呢?尤其是出现bug的时候需要逐行的debug?自己写的代码乱了头绪的确实也见了不少。我们应该做的就是规范开发,减少自己出现的错误。很多时候项目的压力一部分也是由于前期开发中遗留的众多的问题。

还有的人觉得自己可以完成高难度的算法,就认为自己能力很强,不把规范放在眼里。很多人确实是这样,追求个性,大概让别人看他的代码一头雾水更觉得得意。殊不知复杂的算法确实可以体现你个人的逻辑能力,但是绝不代表你的开发水平。我们知道一些开源项目,一些大师级人物写得程序都是极其规范的。并非规范了就代表高水平,实际上是规范的代码更有利于帮助你理解开发语言理解模式理解架构,能够帮助你快速提升开发水平。不明白这点,即使你写的再高明的算法,没准哪天也被当作乱码别处理掉。

记住!每天垒乱码(或许你不觉得,但是大多时候在别人眼中确实就是乱码)并不能使你获得更多的进步,相反要达到高水平的程序员,养成良好的开发习惯是绝对必需的。

不要沉迷表面的得失,看似无用的东西要经过慢慢的累积由量变达到质变的时候,你才能感受到其价值所在。

欢迎更有感触的朋友留下自己的心得分享吧~

【正点原子】嵌入式Linux C代码规范化V1.0_C编程规范_ C编程规范,实现代码简洁,增加代码可读性 立即下载

相关推荐

stm32 + freertos + c++混合编程方法

其他一些资料上面,c++配置成--cpp11或者-cpp 都是把工程配置成c++。三、添加cpp文件,我们调用cpp文件里面的接口函数,不需要修改main.c后缀名。2、配置工程编译时候是--c99,是因为工程里面FreeRTOS是c语言,c++模式会报错。我们这里是默认c,编写的c++文件,单独选择--cpp编译,这在后面配置!c++是面向对象编程,对于一些项目来说,c++编程更加合适!stm32cubemax配置,这里就不写了,配置资料比较多。这里就是让cpp文件在c++下编译。最后,编程成功,点亮!

yuhu0012的博客 2630

程序员入职阿里,发现不重视代码规范!阿里员工:那是给外人看的

一个优秀的开发工程师,他的技术不仅要达到相对靠前的标准,而且平常的编程格式也应该要规范,比如代码对齐、嵌套等等,这些都是老生常谈的话题了,不需要去强调! 可是近日有一位程序员在入职阿里之后,发现这里的程序员对于代码规范似乎都不重要: 可以看到,他曾经纠结了很久的代码规范,可是入职阿里之...

chenqian4525的博客 580

DeepSeek-V3本地Docker容器化部署

通过以上步骤,你可以在本地上成功通过容器化部署DeepSeek-V3。安装完成后,启动Docker Desktop。如果需要后台运行,可以加上。

u013302168的博客 2124

正点原子优化代码系列1——字符串排版

正点原子优化代码系列1——字符串排版 刚刚开始学习嵌入式开发,现在使用的是 正点原子@ALIENTEK 的stm32的板子。 本系列主要记录博主在学习过程中,一些针对正点原子原生代码的优化和一些脑洞想法以及其实现。 在学习正点原子的lcd章节中,正点原子可以提供了一部分可以作为工具使用的原生函数,但是在些代码很多带有小瑕疵。 比如 输出字符串: void LCD_ShowString(u16 ...

qq_27950127的博客 775

ads设计Doherty功放(1)

Doherty功放的设计

qq_40995480的博客 2万+

2025最新OSM中国矢量数据保姆级下载指南(附百度网盘链接)

本文提供2025年OSM中国矢量数据的保姆级下载与使用指南。详细介绍了通过Geofabrik镜像站、QGIS插件及第三方平台获取数据的多种途径,重点解析了Shapefile格式数据的结构、WGS84坐标系特性,并指导进行格式转换与基础GIS应用,帮助用户高效合规地获取并利用这份开放地理数据资源。

weixin_29228781的博客 884

【编程态度】20个写代码的不规范案例

今天跟大家聊一个有趣的话题:如何写出让人抓狂的代码?大家看到这个标题,第一印象觉得这篇文章可能是一篇水文。但我很负责的告诉你,它是一篇有很多干货的技术文。曾几何时,你在阅读别人代码的时候,有没有抓狂,想生气,想发火的时候?今天就跟大家一起聊聊,这20种我看了会抓狂的代码,看看你中招了没?

程序源日志的博客 1400

Fanuc机器人的坐标变换矩阵的研究2

一、Funuc用户坐标系的介绍 二、用户坐标系与世界坐标系的坐标转换 三、 以用户坐标系1为基础旋转变换后的用户坐标系 四、关于点的WPR的含义 4.1:点在用户坐标系和世界坐标系下的坐标关系 4.2 通过转换矩阵返回去推导WPR

qq_34047402的博客 1525

编程不规范,前途两茫茫

这篇重点介绍一下代码编程的排版风格和自动排版工具,希望在编程方面能对大家有所帮助。代码规范化中的排版基本上有七大风格,主要体现在缩进、空行、代码行、空格、成对书写、对齐、注释七方面的书写规范上。

weixin_39266374的博客 500

微信公众号 - 超详细 H5 网页接入微信支付功能,开发网站微信支付最详细的教程示例代码(微信公众号前端支付 JS-SDK / JSAPI 微信H5授权登录支付,唤起微信支付)最新超级详细教程

H5页面接入微信支付功能,前端网页端怎么做微信JSAPI支付,vue网站接入微信JSSDK支付,vueH5项目如何做使用微信支付,端h5调用微信支付jsapi方法,前端vue开发的H5网站怎么微信支付最详细的教程示例代码,vue怎么调取微信支付流程,将H5接入微信支付退款,vue网站怎么搞微信支付,H5前端开发网站在微信环境内H5调起微信支付,react项目h5如何调用微信支付的方法,nuxt.js项目vueH5集成微信JS支付,网站怎么做出H5微信公众号支付,请问vue.js这个框

🏆 前端领域优质创作者 8126

SAP B1中文培訓教材_SDK

公司内部培训资料,对开发工具 ,DIAPI, UIAPI,Add-ON有详细解说

代码不规范,亲人两行泪

代码不规范引发的血案: 美国的一家名为 WTS Paradigm 的企业资源规划软件(ERP)开发商的办公楼内,该公司的一名程序员持枪杀了4名同事,因他们总是不写注释,不遵循驼峰命名,最主要还天天git push -f 。当时43岁的安东尼·汤(Anthony Tong)在办公室,拿出一把事先藏起来的半自动手枪向周围4名同事开火。其他工作人员见状纷纷逃离办公楼,跑到附近的公司避难。当警察来到现场时,他竟然还想袭击警察!看来这位程序员真是被愤怒冲昏了头脑,因他的不配合,最后警察不得已向他开枪,在送往医院的途

qq_59414216的博客 807

pscad IEEE标准系统搭建说明

pscad IEEE标准系统搭建说明,包含典型的IEEE 9节点、14节点、30节点、39节点和118节点系统。内含标准测试系统的原始数据和潮流结果。

骂人的代码_代码不规范?985,211也不要

为什么写代码要规范?可以说代码是程序员的第二张脸场景:要讨论这个问题,我们首先得说点其他的。我们来假设一个场景:相信每个朋友最开始都有这种感受:哇,今天状态超好,简直是文若铅华,丝若泉涌。敲起键盘来简直感觉不要太顺畅。随着一连串的编写,可能写完抬头一看一上午或者一下午就过去了。要么是饭点,要么就该要下班了。在想一想自己今天的状态,那感觉不要太好。然后高高兴兴就回家或者吃饭去了。之前的事情告一段落。...

weixin_40002692的博客 1985

Statistics and Machine Learning Toolbox

Statistics and Machine Learning Toolbox(带书签),MATLAB统计学习工具

华为的C语言编程规范.pdf

华为技术有限公司内部技术规范。本规范制定了编写C语言程序的基本原则、规则和建议。从代码的清晰、简洁、可测试、安全、程序效率、可移植各个方面对C语言编程作出了具体指导。

多所985、211高校教授被通报!国自然发布处理决定!

点击下方卡片,关注“CVer”公众号AI/CV重磅干货,第一时间送达本文转载自:募格学术 | 来源:国家自然科学基金委员会官网、解螺旋10月22日下午,国家自然科学基金委员会官网发布了《2...

阿木寺的博客 782

写给那些学校不是985、211的同学们

【 声明:版权所有,欢迎转载,请勿用于商业用途。  联系信箱:feixiaoxing @163.com】       每年的6、7月份都是一年一度的毕业季。按照某些新闻机构的统计数字来说,现在每一年毕业的人数达到了600万之多。然而随着社会经济的放缓、贫富差距的拉开,找工作变得越来越困难。公务员考试不好考、事业单位进不去、国有企业和外资企业门槛高、中小企业不规范,对于那些不是985、21

u010843358的专栏 707

【申论】规范表达-科技创新类

欢迎大家指正、补充。

RisunJan的博客 1220

随想录(写给那些学校不是985、211的同学们)

【 声明:版权所有,欢迎转载,请勿用于商业用途。  联系信箱:feixiaoxing @163.com】     每年的6、7月份都是一年一度的毕业季。按照某些新闻机构的统计数字来说,现在每一年毕业的人数达到了600万之多。然而随着社会经济的放缓、贫富差距的拉开,找工作变得越来越困难。公务员考试不好考、事业单位进不去、国有企业和外资企业门槛高、中小企业不规范,对于那些不是985、211的同学,一切

嵌入式-老费,一个分享专业嵌入式知识的blog 7101

又是一年毕业季--写给那些不是985、211院校的同学

【 声明:版权所有,欢迎转载,请勿用于商业用途。  联系信箱:feixiaoxing @163.com】     每年的6、7月份都是一年一度的毕业季。按照某些新闻机构的统计数字来说,现在每一年毕业的人数达到了600万之多。然而随着社会经济的放缓、贫富差距的拉开,找工作变得越来越困难。公务员考试不好考、事业单位进不去、国有企业和外资企业门槛高、中小企业不规范,对于那些不是985、2

算法之道 829

“你太丑了“, 你不符合该岗位要求 !

有人说:“这公司也太过分了,招聘看的是能力,又不是选美,咋能因为长相拒绝人呢?” 更有热心网友,直接把头像换成该公司负责人的照片,在招聘软件上用同样的话 “回敬” 对方,帮小陈出出气。按照法律规定,用人单位招聘时,不能因为民族、种族、性别、宗教信仰,当然也包括长相,去歧视求职者。公司出了这档子事儿,不反思、不道歉,还这么傲慢,这管理和企业文化,真的让人怀疑。哪晓得,对方 HR 直接来了句 “不行,太丑了”。也提醒各位求职者,遇到就业歧视,别忍气吞声,一定要勇敢站出来,用法律武器维护自己的权益。

335

计算机专硕可以跨专业调剂吗,学硕不能调专硕了?调剂政策有变!不允许跨门类调剂!...

近期,小可爱们有关注研招网公布的调剂细则吗?知道今年(21考研)相比去年(20考研)调剂要求方面发生了些变化吗?没关注也没关系,学长已经给大家整理好了~2021考研调剂:第一处变化今年调入专业与第一志愿报考专业相同或相近,应在同一学科门类范围内。去年调入专业与第一志愿报考专业相同或相近。考研共有13大门类类别,分别是:01哲学、02经济学、03法学、04教育学、05文学、06历史学、07理学、08...

weixin_39771775的博客 1998
上一篇: C语言很难学?不不不,只需要这几步!
下一篇: C语言怎么学?惊!四大圣经!
CodingPs
博客等级 码龄7年 182粉丝 253原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值