命名

优质

小牛编辑

144浏览

2023-12-01

命名

程序设计的真正难题是替事物命名及使缓存失效。

——Phil Karlton

标识符使用英文命名。

# 差 - 标识符使用非 ASCII 字符
заплата = 1_000
# 差 - 标识符使用拉丁文写法的保加利亚单词
zaplata = 1_000
# 好
salary = 1_000

符号、方法、变量使用蛇底式小写（snake_case）。

# 差
:'some symbol'
:SomeSymbol
:someSymbol
someVar = 5
var_10 = 10
def someMethod
  ...
end
def SomeMethod
 ...
end
# 好
:some_symbol
some_var = 5
var10 = 10
def some_method
  ...
end

给符号、方法、变量命名时，避免分隔字母与数字。

# 差
:some_sym_1
some_var_1 = 1
def some_method_1
  # 做一些事情
end
# 好
:some_sym1
some_var1 = 1
def some_method1
  # 做一些事情
end

类与模块使用驼峰式大小写（CamelCase）。（HTTP、RFC、XML 等首字母缩写应该仍旧保持大写形式）

# 差
class Someclass
  ...
end
class Some_Class
  ...
end
class SomeXml
  ...
end
class XmlSomething
  ...
end
# 好
class SomeClass
  ...
end
class SomeXML
  ...
end
class XMLSomething
  ...
end

文件名使用蛇底式小写，如 hello_world.rb。
目录名使用蛇底式小写，如 lib/hello_world/hello_world.rb。
尽量使一个源文件中只有一个类或模块。文件名就是类名或模块名，但使用蛇底式小写而不是驼峰式大小写。
其他常量使用尖叫蛇底式大写（SCREAMING_SNAKE_CASE）。
```
# 差
SomeConst = 5
# 好
SOME_CONST = 5
```
谓词方法（返回布尔值的方法）的名字应当以问号结尾。（比如 Array#empty?）。不返回布尔值的方法不应以问号结尾。

谓词方法的名字应当避免使用 is、does、can 等助动词作为前缀。这些助动词在实际场景中显得冗余，且与标准库的命名习惯（比如 empty?、include?）很不一致。

# 差
class Person
  def is_tall?
    true
  end
  def can_play_basketball?
    false
  end
  def does_like_candy?
    true
  end
end
# 好
class Person
  def tall?
    true
  end
  def basketball_player?
    false
  end
  def likes_candy?
    true
  end
end

具有潜在危险性的方法，当其存在对应安全版本的方法时，其名字应当以惊叹号结尾。（比如修改 self 或参数值的方法、相对 exit 方法不会在退出时运行 finalizers 执行清理工作的 exit! 方法等）
```
# 差 - 没有对应安全版本的方法
class Person
  def update!
  end
end
# 好
class Person
  def update
  end
end
# 好
class Person
  def update!
  end
  def update
  end
end
```

尽量根据危险方法来定义对应安全版本的方法。

class Array
  def flatten_once!
    res = []
    each do |e|
      [*e].each { |f| res << f }
    end
    replace(res)
  end
  def flatten_once
    dup.flatten_once!
  end
end

当定义二元操作符时，将参数命名为 other（<< 与 [] 例外，因为其语义与此不同）。
```
def +(other)
  # 省略主体
end
```