查看原文
其他

看了这么多代码,谈一谈代码风格!

程序员Carl 代码随想录 2021-05-18

别忘了给「代码随想录」加星标哦!

最近看了很多录友在leetcode-master上提交的代码,发现很多录友的代码其实并不规范,这一点平时在交流群和知识星球里也能看出来。

很多录友对代码规范应该不甚了解,代码看起来并不舒服。

所以呢,我给大家讲一讲代码规范,我主要以C++代码为例。

需要强调一下,代码规范并不是仅仅是让代码看着舒服,这是一个很重要的习惯。

题外话

工作之后,特别是在大厂,看谁的技术牛不牛逼,不用看谁写出多牛逼的代码,就代码风格扫一眼,立刻就能看出来是正规军还是野生程序员

很多人甚至不屑于了解代码规范,认为实现功能就行,这种观点其实在上个世纪是很普遍的,因为那时候一般写代码不需要合作,自己一个人撸整个项目,想怎么写就怎么写。

现在一些小公司,甚至大公司里的某些技术团队也不注重代码规范,赶进度撸出功能就完事,这种情况就要分两方面看:

  • 第一种情况:这个项目在业务上具有巨大潜力,需要抢占市场,只要先站住市场就能赚到钱,每年年终好几十万,那项目前期还关心啥代码风格,赶进度把功能撸出来,赚钱就完事了,例如12年的微信,15年的王者荣耀。这些项目都是后期在不断优化的。

  • 第二种情况:这个项目没赚到钱,半死不活的,代码还没有设计也没有规范,这样对技术人员的伤害就非常大了。

而不注重代码风格的团队,99.99%都是第二种情况,如果你赶上了第一种情况,那就恭喜你了,本文下面的内容可以不用看了,哈哈。

代码规范

变量命名

这里我简单说一说规范问题。

权威的C++规范以Google为主,我给大家下载了一份中文版本,在公众号「代码随想录」后台回复:googlec++编程规范,就可以领取。

具体的规范要以自己团队风格为主,融入团队才是最重要的。

我先来说说变量的命名。

主流有如下三种变量规则:

  • 小驼峰、大驼峰命名法
  • 下划线命名法
  • 匈牙利命名法

小驼峰,第一个单词首字母小写,后面其他单词首字母大写。例如 int myAge;

大驼峰法把第一个单词的首字母也大写了。例如:int MyAge;

通常来讲 java和go都使用驼峰,C++的函数和结构体命名也是用大驼峰,大家可以看到题解中我的C++代码风格就是小驼峰,因为leetcode上给出的默认函数的命名就是小驼峰,所以我入乡随俗

下划线命名法是名称中的每一个逻辑断点都用一个下划线来标记,例如:int my_age下划线命名法是随着C语言的出现流行起来的,如果大家看过UNIX高级编程或者UNIX网络编程,就会发现大量使用这种命名方式

匈牙利命名法是:变量名 = 属性 + 类型 + 对象描述,例如:int iMyAge,这种命名是一个来此匈牙利的程序员在微软内部推广起来,然后推广给了全世界的Windows开发人员。

这种命名方式在没有IDE的时代,可以很好的提醒开发人员遍历的意义,例如看到iMyAge,就知道它是一个int型的变量,而不用找它的定义,缺点是一旦该变量的属性,那么整个项目里这个变量名字都要改动,所以带来代码维护困难。

目前IDE已经很发达了,都不用标记变量属性了,IDE就会帮我们识别了,所以基本没人用匈牙利命名法了,虽然我不用IDE,VIM大法好。

我做了一下总结如图:

编程风格

水平留白(代码空格)

经常看到有的同学的代码都堆在一起,看起来都费劲,或者是有的间隔有空格,有的没有空格,很不统一,有的同学甚至为了让代码精简,把所有空格都省略掉了。

大家如果注意我题解上的代码风格,我的空格都是有统一规范的。

我所有题解的C++代码,都是严格按照Google C++编程规范来的,这样代码看起来就让人感觉清爽一些

我举一些例子:

操作符左右一定有空格,例如

i = i + 1;

分隔符(,;)前一位没有空格,后一位保持空格,例如:

int i, j;
for (int fastIndex = 0; fastIndex < nums.size(); fastIndex++)

大括号和函数保持同一行,并有一个空格例如:

while (n) {
    n--;
}

控制语句(while,if,for)前都有一个空格,例如:

while (n) {
    if (k > 0) return 9;
    n--;
}

以下是我刚写的力扣283.移动零的代码,大家可以看一下整体风格,注意空格的细节!

class Solution {
public:
    void moveZeroes(vector<int>& nums) {
        int slowIndex = 0;
        for (int fastIndex = 0; fastIndex < nums.size(); fastIndex++) {
            if (nums[fastIndex] != 0) {
                nums[slowIndex++] = nums[fastIndex];
            }
        }
        for (int i = slowIndex; i < nums.size(); i++) {
            nums[i] = 0;
        }
    }
};

这里关于大括号是否要重启一行?

Google规范是 大括号和 控制语句保持同一行的,我个人也很认可这种写法,因为可以缩短代码的行数,特别是项目中代码行数很多的情况下,这种写法是可以提高阅读代码的效率。

当然我并不是说一定要按照Google的规范来,代码风格其实统一就行,没有严格的说谁对谁错

总结

如果还是学生,使用C++的话,可以按照题解中我的代码风格来,还是比较标准的。

如果不是C++就自己选一种代码风格坚持下来,

如果已经工作的录友,就要融入团队的代码风格了,团队怎么写,自己就怎么来,毕竟不是一个人在战斗。

旧文链接:看了这么多代码,谈一谈代码风格!

-------------end------------

最后欢迎大家加入「代码随想录」知识星球,如果想看看星球里面都有啥,长按下图,可以预览星球内容哈,上百录友在这里打卡分享自己每天的学习成果,一个人默默的学习是孤单的,来吧,这将是今年你最值得的一笔投资!

有些事情自己孤独坚持有点苦,但有一群人一起坚持,甚至会发现原来有点意思呀。 

大家加入星球后,也顺便添加我的个人微信,备注:简单自我介绍+知识星球+自己的知识星球昵称。我会给大家单独拉一个星球群(避免大家错过重要通知)。 

Hello,我是Carl,哈工大师兄,ACM亚洲区铜牌打杂,先后在BAT中的两家采坑,一位文舞双全的程序员。
刷题攻略全部整理到了Github :https://github.com/youngyangyang04/leetcode-master,方便大家在电脑上阅读,这个仓库每天都会更新,大家快去给一个star支持一下吧!
大家可以在公众号左下角「刷题攻略」(公众号左下角)里查看详细攻略。
同时我在B站更新算法视频,B站同名:代码随想录
后台回复:666,可以获得Carl原创算法手册 

点击【阅读原文】直达B站

    您可能也对以下帖子感兴趣

    文章有问题?点此查看未经处理的缓存