变量的命名

变量命名

---

There are only two hard things in Computer Science: cache invalidation and naming things.

在计算机科学中只有两件难事：缓存失效和命名。

copy from
fanrong_github

关于内容

• text 文本
• value 值
• html 超级文本标记语言
• string 字符串

- content xx的内容

关于时间

• create_time 创建时间
• update_time 更新时间
• pay_time 付款时间
• delivery_time 配送时间
• consign_time 发货时间
• last_login_time 上次登录时间

关于数量

• number 都用来形容具体数字，比如 trade_no 交易号
• quantity 则集中体现是数量和质量
• favorites_count 收藏数
• likes_count 喜欢数
• comments_count 评论数
• followers_count 被关注数
• followings_count 关注数

关于金钱

• available_amount 可用余额
• freeze_amount 不可用余额
• in_amount 收入金额
• out_amount 支出金额

• balance 当时账户的余额

• price 商品价格

• post_fee 邮费
• discount_fee 优惠金额
• total_fee 商品金额（商品价格乘以数量的总金额）
• adjust_fee 卖家手工调整金额

• commission_fee 交易佣金

• total_amount 订单总金额

关于开始和结束

begin，end，start，stop这是词义正好相反的两组词。
begin 的反义词为 end；start 的反义词为 stop。

begin 表示“开始”，其内涵是“使处于进程中”，某个时刻节点。
start 表示“开始”，其内涵是“启程”，由静变动。

例如，“那次会议是上星期开始的”(The meeting began last week.)会议是个“过程”，在这个意义上用 begin 恰当；
而“千里之行始于足下”(A thousand-li journey is started by taking the first step.)所包含的意义是启步， 所以用 start 恰当。

处于运动中的物体的停止，实际上是“由动到静”，这时应当用 stop。
stop 适用于行为或进程。如两个人吵架，你大声道“别吵了！”用英语说应为：Stop it!

总结

所以很明显，开始时间和结束时间是用begin_time和end_time（时间节点），而不是start_time！

播放器开始播放，start 和 stop（由静变动，动作）。

from, to 就不需要我多解释了，从哪里到哪里，一个地点到一个地点。

关于bool变量

只要你觉得它需要 “是否xxx”，那我们就用 is_ 为前缀来命名它们，下次你只要看到 is_ 开头的就知道它是布尔类型。

我们要站在用的角度，去命名布尔类型，方便理解，比如大部分都是在使用查找启用的用户，而不是看被禁用的用户，所以命名为 is_enabled=1， 而不是 is_lock=0 来查找启用的用户会更好。因为 is_lock=0 需要程序猿的思维转换两次，尽量减少程序猿的思考。

2.示例：

is_verify // 是否验证，0-待审核，1-审核通过
is_deleted // 是否删除，0-未删除，1-删除
is_read // 是否阅读，0-未读，1-已读
is_enabled // 是否启用（上架下架、锁定...），0-是，1-否
is_recommend // 是否推荐，0-否，1-是

关于图片

picture 通常指一幅图画，凡是有图的东西都可以称为 picture；
image 通常指“形象”。比如你给对方留下的印象，任何可以说得上名称的图片。如果是乱画，那
就谈不上形象，而只是 picture；
photo 更多的时候是指用 camera 形成的相片。

photo 表示照片， picture 可以指照片也可以表示画， image 前面两者都可表示，涵盖所有图象。
从类属来讲， photo < picture < image

so…，我是这样来区分的：

用户上传的都是 picture；
网页上可以说的上名称的叫 image；
所有图片都是 picture，通过picture_id关联。