问题

我待过国内外大小公司,做过保险,零售,物流,金融,电商,电力等行业,用过 java, nodejs, ruby 等语言。

我发现写代码取名字是一个不大不小的问题,好的命名可以大大增加代码的可读性,帮你理解逻辑和业务,减少 bug。 但取一个合适的名字,并不总是一个简单的事。

  • 你不懂业务,一些名词,专业术语,你想不到合适的词。
  • 你很难看懂其它人写的代码。那些代码可能是另一个不太懂的人当时尽最大努力想到的一个合适的词。
  • 在某个小圈子有较好的命名规范,但和其他圈子没统一。如是否为类添加后缀。
  • 多音多义字的翻译。一个中文对应多个英文,或者一个英文对应多个中文。哪个更合适?
  • 通用简写,对某些人是常识,对其他人是疑问

规范

  1. 可读性大于简洁, schoolName 远远好于 schName
  2. restful api
  3. springboot, rails

软件词典

  • 中文, 英文互搜,主要是中文翻译英文
  • 与该词对应的业务场景,有简单介绍
  • 搜已有代码库
  • tag,评论,点赞
  • 建议,可选,警告,搜索次数

参考

分词 中华字典,牛津词典,翻译软件 wiki,百度百科 其他代码 https://unbug.github.io/codelf/ 阿里巴巴java开发手册 Airbnb JavaScript Style Guide

serverless 架构