# 通用编码规约
适用于多种编程语言的编码规约。对应的规约工具主要是 EditorConfig (opens new window) 和 Prettier (opens new window)。
# 强制 使用 2 个空格缩进
<!-- bad -->
<html>
∙∙∙∙<head>
∙∙∙∙∙∙∙∙<title></title>
∙∙∙∙</head>
</html>
<!-- good -->
<html>
∙∙<head>
∙∙∙∙<title></title>
∙∙</head>
</html>
之所以选择两个空格,是有以下考虑:
- 空格在所有编辑器和网页中展示的效果均一致,而 Tab 则无法控制实际展示的缩进宽度。
- 2 个空格相比 1 个空格更加明显。
- 2 个空格相比 3 个空格或 4 个空格更节约空间,适合
html和jsx等层级较深的语法。
EditorConfig 配置:
indent_style = space
indent_size = 2
# 推荐 折行行宽 100 字符
硬换行能提高代码阅读和调试的效率。我们考虑了在等效 1600px 宽的屏幕,左右分屏对比代码的情况。对于更小的屏幕,我们建议调小字体或者缩放比例。
EditorConfig:
max_line_length = 100
VS Code 设置:
{
"editor.rulers": [100]
}
# 强制 使用 UTF-8 字符集
所有源代码和纯文本文件都应使用 UTF-8 字符集来编码和解码。
EditorConfig 配置:
charset = utf-8