Skip to content

Latest commit

 

History

History
70 lines (44 loc) · 1.1 KB

readme.md

File metadata and controls

70 lines (44 loc) · 1.1 KB

通用规则

目录

  • 文件和路径
  • 编码
  • 缩进
  • 每行字符数
  • 行尾空白符
  • 换行
  • 文件末尾空行
  • 文件行数
  • 注释

文件和路径

DO

  • 项目中的文件存放在同一个目录中
  • 使用完整的相对路径引用其他文件
  • 使用小写字母和数字
  • 使用 .- 作为单词的连接符
  • 路径中始终包含扩展名

DON'T

  • 使用本地绝对路径
  • 使用路径别名

编码

使用 UTF-8(no BOM)。

缩进

DO

  • 使用两个或四个空格缩进

DON'T

  • 使用 Tab 缩进
  • 混合多种缩进方式

每行字符数

每行尽量保持在 80 字符以内,不超过 100 字符。

行尾空白符

行尾不使用任何空白符。

换行

  • 以保证代码易读为首要目标
  • 通过缩进表现多行内容的关系
  • 使用 Unix 换行符 LF \n

文件末尾空行

文件末尾保留一个空行。

文件行数

每个文件尽量保持在 500 行以内,不超过 1000 行。

注释

  • 在需要的地方添加注释
  • 编写简洁、明确的注释内容