如何保证代码格式统一?

Tooth

多人协作时时常会出现你爱 Tab 他爱空格,你缩进 2 个字符,他爱 4 个字符的问题,还有换行符乱码、文章末尾空行……

不同编辑器的对缩进处理方法迥异,如何解决?前辈们已经找到了解决方案 EditorConfig,如何用好这个方案,就是今天想聊的话题。

一、代码风格指的的哪些内容

  1. 编码
    如今 UTF-8 已成互联网的事实标准,建议采用 UTF-8。推荐一篇非常好有关字符编码文章 理解字符编码
  2. 代码缩进
    有些语言是强制缩进,例如 Python 强制 4 个空格缩进。
  3. 换行符
    不同操作系统的换行符采用不同的编码风格,这可能导致隐形 bug,Linux上创建的文件在Windows上打开时,结果所有内容会挤成一行。而Windows上创建的文件在Linux上打开时,每一行的结尾又多了一个奇怪字符 ^M。想深入了解,可以阅读 知无涯之回车换行的故事
# 不同操作系统换行符采用的编码
LF:在Unix或Unix相容系統(GNU/Linux,AIX,Xenix,Mac OS X,...)、BeOS、Amiga、RISC OS
CR+LF:MS-DOS、微軟視窗作業系統(Microsoft Windows)、大部分非Unix的系統
CR:Apple II家族,Mac OS至版本9
  1. 结尾空行

一些早期的工具(编辑器/解释器/终端……等)会错误地认为:如果一个文件的结尾不是新行(没有回车或换行符)那么它读取到的内容不是正常结束,而是使用 ^Z(即 EOF Mark)结束的。这会导致这些工具不能正常工作。

结尾空行可以避免合并文件时,没有换行导致的错误,所以建议末尾保留空行。

二、如何保证代码风格一致
能够影响代码风格的配置:

  1. 每个人书写代码习惯的影响
  2. 项目中 EditorConfig 配置
  3. 编辑器相关设置
  4. 格式化代码工具如:beautify
  5. 代码风格检查工具,如:JSLint

人是不可靠的,最好还是通过软件的控制来避免代码格式混乱的问题,那么我们首先考虑下我们需要的格式规范。以下罗列我期望的格式:

编码:UTF-8
换行符:LF
代码缩进:space
结尾空行:保留空行

为什么优先采用空格缩进?
其实,写了个项目缩进采用 Tab 感觉还不错,会发现有时对齐困难,需要借助 Space 对齐。
当写 Coffee JS 时,从别处粘贴的代码由于采用的是空格,会发现运行错误。网上查了很多资料,还是统一采用 Space 更简单粗暴,几乎所有编辑器都有 softTab 功能,及将 Tab 自动转换为空格使用。

三、落实代码风格方案

  1. 配置 .editorconfig
    每个项目,从开始建立,就需要配置 .editorconfig 文件。
    EditorConfig配置文件从上往下读取,并且路径最近的文件最后被读取。匹配的配置属性按照属性应用在代码上,所以最接近代码文件的属性优先级最高。
root = true
[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
[*]
indent_style = space
indent_size = 2
[*.md]
trim_trailing_whitespace = false
[*.py]
indent_style = space
indent_size = 4
  1. 配置编辑器
    例如,目前所用编辑器 VSCode
{
  "files.encoding": "utf8",
  "files.eol": "\n",
  "files.insertFinalNewline": true,
  "editor.insertSpaces": true,
  "editor.tabSize": 2,
}
  1. 配置代码格式化工具 beautify
  "beautify.config": {
    "indent_size": 2,
    "indent_char": " "
  }
  1. 代码检查工具
    暂时,我没有设置,如有需要只需看文档自行配置。

四、最后
我在编辑器是打开 "editor.renderWhitespace": "all" 选项的,这样可以方便查看文件的缩进风格。

所有的工具只是提供方便,关键其实在第一条,只要「人」能对自己要求严格点,与团队保持统一,那么代码风格问题就能迎刃而解。

参考资料

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

推荐阅读更多精彩内容