代码缩进排版风格有必要统一吗?

发布于 2022-08-28 12:31:34 字数 138 浏览 20 评论 0

一个大型的项目中通常有好几个开发人员,有些人的代码风格就是不一样。在阅读整个项目源码的时候显得比较困难。对于这样的情况,有必要让项目中所有人都统一遵循的代码风格吗?
注:这里说的代码风格不同于代码规范。代码风格多指缩进使用空格还是tab这一类的问题。

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(13

月寒剑心 2022-09-04 12:31:34

我是来发出一点不同/奇葩的声音的。
我认为:代码的缩进排版风格完全没有必要统一!

不过且慢,前提是你的团队成员都使用了有高级代码格式化功能的IDE,并且项目版本库设置了提交前自动格式化代码的hook!

试想一下,你将自己的IDE配置成自己喜欢的排版风格,然后打开代码文件时,IDE都自动将代码重新格式化成你的prefer风格;你编辑好代码保存之后,提交到版本库,比如Git或Hg,并且在版本库上设置了一个before commit的hook,对所有要进入版本库的源代码都按照一个统一的排版方式重新格式化后再提交到版本库。这样,每个人都可以使用自己喜欢的代码排版方式Coding or Review,也不会影响其他人。(之所以要在代码进库之前再format到标准格式,是为了便于diff,目前基于程序语义的diff/merge工具也没被开始应用——所以会有这种因为diff/merge产生的BUG:http://coolshell.cn/articles/11112.html

但那只是想象,我从来没听说过哪个团队使用这种方案。因为这个方案有这样几大阻碍:

  1. 找不到一个好的格式化代码的工具!你的IDE总是会在格式化代码方面有这样那样的小问题。你自己IDE有问题也就算了,问题是,你也找不到一个好的工具,设置版本库的hook,在代码进库前,调用这个工具,对所有代码进行reformat!
  2. 对于Java这种中规中矩的语言,倒容易找到这样的工具,Golang甚至内置了一个go format。但对于Python呢?它将缩进当成语义的一部分啊。对于Java,要是工具处理缩进错了仅仅导致看起来不爽而已,Python自动缩进不正确的话,代码就彻底错了啊!而且有时缩进错误会成为一个潜在的Bug、而不是直接报SyntaxError!或许你会说,我们团队又不用Python这种2B语言,我们就不用这样提心吊胆了。
  3. 但你还是找不到那种可以按你的偏好设置对代码进行完美地重新排版格式化的工具啊!TOT!别说「按偏好格式化」了,就算按标准格式化,你在Vim里试试对uglify之后的jQuery源码重新format一下看看。而且你的团队都是用同一种IDE么?只用Java一种语言么?真的只用Java一种语言么?话说你连Java这么死板的语言都能忍受,却不能忍受一下团队规范?TeamLeader看着你意味深长地说:“我觉得你不是一个合格的Java程序员啊!”
  4. 好了,假设你真的找到一个完美格式化代码的工具+一个高级IDE了! 你们团队不会是用的VSS作版本管理吧?Before commit的hook怎么设置?个个都会设置么?TeamLeader睬你么?格式化工具出Bug了你能去FIX么?你找来的工具有商业支持么?不会是某个Ph.D做了玩玩的毕业作品吧?

最后,你只能去墙角默哀!

如果这样的工具(代码排版格式化、甚至结构化编辑的IDE)在业界受到广泛支持与应用,我想我们就不必在缩进是用空格还是Tab的问题上争论不休了.假如能根据代码语义进行格式化的IDE和工具链成熟了,我们就可以不要脸地在代码中混用Tab和Space了,呵呵。
在IDE还没有对变量名函数名重构功能(将一个函数名重命名后,IDE自动将项目中所有调用到该函数的地方的名字也改成新的名字)的时代,软件项目中就有各种历史遗留的命名问题。你发现项目中一个函数的名称拼写错了有歧义,想要修改正确,但好多地方都调用到了这个函数,没有IDE的refactor功能帮助,谁敢动这大段代码啊,改漏了出错了可承担不起啊。(直到golang才终于有机会将creat拼写错误修正了)。

所以,结论是,囿于现状,团队成员必须都使用相同的代码排版规范

再补充说说命名规范。
和代码排版问题不一样,这个东西肯定没有办法用IDE自动格式化。但从另一面来看,不但团队需要一个命名规范,而且,不同的语言、不同的开发框架,其规范应该是近似固定的。

  1. 比如对于Java,肯定是使用CamelCase!为什么?因为标准库全是这种风格的命名!其实Java甚至应该禁止在标识符中使用下划线的。
  2. 上面的观点一点不极端啊。Golang用函数名首字母大小写来区分它是public还是private。Python用双下划线来隐藏方法。 JavaScript也有这个潜规则,用前后双下划线表示内部实现。Ruby将全部大写的变量视为常量,类名模块名必须首字母大写!
  3. 而且对于另一些语言,命名规范会影响程序正确性!比如PHP!它的函数名是不区分大小写的。所以对于PHP,更推荐是全局函数名使用下划线,类名变量名使用CamelCase!

可见,对于命名规范问题,其实根本不是什么强迫别人遵守什么代码规范,而是为了将代码语义最佳化,每种平台或语言都形成了自己的一种命名传统(Naming convention)。假如一个Java程序员要是给每个变量名都像int i_count;float f_percent;这样加个下划线和类型提示,要么不会用IDE,要么就是有病,这种将其它平台或语言上的习惯带到Java上肯定不受人待见。当然你会遇到有些语言中变量方法名既流行camelCase又流行under_score,比如Python、PHP之类的,那是,因为,它们本来就是一个不规范的语言,它们的标准库的命名本来就很不一致(又黑了一把)!

如果命名规范的不同 不影响程序的正确性或语义,那最后只有一个标准规范:就是统一。
在同一个项目中始终使用同一个规范。你不能因为下划线在键盘上难输入或是你的Shift、CapsLock键坏了就坚持打这个反传统的圣战。

多关心关心程序的正确性及表现力,给函数起一个易懂且具概括性的名字,是under_score还是CamelCase,并不很能体现一个程序员的执著审美与品味。

月寒剑心 2022-09-04 12:31:34

来自知乎
请输入图片描述

紫南 2022-09-04 12:31:34

缩进/tab/换行等排版风格应当统一,所有人都这么说,但个人感受对非开源的商业项目来说重要性不那么高(除非项目成员都有代码洁癖)

另一类代码风格比如整体结构、异常处理、分装颗粒度等这些更加需要统一,虽然统一的难度比排版风格难很多,但统一带来的好处(混乱带来的坏处)也大很多。题目中已经提到的代码阅读困难实际上正是项目崩溃的重要信号:在阅读困难的代码上工作,程序员往往选择patch/hack的编程方式,使代码越来越难以维护。

排版混乱的项目如果阅读困难好歹很容易用个脚本就能拯救。但一边面向对象消息驱动,另一边面向过程配置驱动,每个成员各自有自己的一套异常处理风格的项目,仅是想象一下我就感觉脑内有马赛克出来了……

建议:团队需要花一些时间开会大家统一代码风格,写一份文档把会议(投票)结果记录下来,然后拿着这份文档互相CodeReview保证风格统一,乱写的拉出去弹丁丁

瞳孔里扚悲伤 2022-09-04 12:31:34

规范里肯定包含了缩进的要求呀,用什么符号缩,缩多少,甚至包括括号之前之后是否有空格,大括号是新行还是旧行,细致的规范保证了协同工作时候互相阅读没有障碍、很多语言甚至有检查风格是否规范的工具。。。帮助项目程序员在提交代码之前自行检查:)缩进是非常有必要规范的,因为有人喜欢用空格,有人喜欢用 tab, 他们修改彼此 的代码时, 就容易出现“删一下,还是删四(或者八)下的问题”

统一是有价值的,而且价值很大。

在此想到了一篇文章《Google为何要执行严格的代码规范》中有这么一段话:

在谷歌,我可以查看任何的代码,进入所有谷歌的代码库,我有权查看它们。事实上,这种权限是很少人能拥有的。但是,让我感到惊讶的却是,如此多的编码规范—缩进,命名,文件结构,注释风格—这一切让我出乎意料的轻松的阅读任意一段代码,并轻易的看懂它们。这让我震惊—因为我以为这些规范是微不足道的东西。它们不可能有这么大的作用—但它们却起到了这么大的作用。当你发现只通过看程序的基本语法结构就能读懂一段代码,这种时间上的节省不能不让人震撼!

ぃ弥猫深巷。 2022-09-04 12:31:34

这个要分情况:

  • 如果你们的代码会被自动将tab转成空格,一定要统一tab的宽度,否则缩进宽度不一致,代码阅读起来可恶心了。
  • 如果不会将tab自动转成空格,并且团队都已经约定好,不用空格来缩进,一律用tab来缩进。这种情况下,我的建议是不要强制tab的宽度。因为各有各的偏好,你喜欢2字符宽度,我喜欢4字符,他喜欢3字符也说不定。同样一个tab,在各自的IDE下按照各自的偏好的宽度呈现,各取所好,相安无事。
千鲤 2022-09-04 12:31:34

找个规范大家一起遵循吧,大厂的规范一搜一大把

王权女流氓 2022-09-04 12:31:34

未必要统一,但是至少不会对其他开发人员造成阅读困难吧。

茶底世界 2022-09-04 12:31:34

很重要,虽然我很少团队干活思密达。

吹梦到西洲 2022-09-04 12:31:34
  • 有用Tab缩进的
  • 有用空格缩进的
    • 有用两个空格的
    • 有用四个空格的

这让版本控制怎么弄?
还要不要 Code Review 了?

无所谓啦 2022-09-04 12:31:34

要一致。。。不然CODE REVIEW就恶心了

掀纱窥君容 2022-09-04 12:31:34

要一致,要不然,恶心的就不止你的队友了

梦幻之岛 2022-09-04 12:31:34

肯定必须统一,不然看代码都很费劲的。

停顿的约定 2022-09-04 12:31:34

蛋疼的问题,不知道为什么官方还要把这个问题推到微博上大家一起来参与。。。。说话比较直,见谅。

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文