各位如何看待开发的过程中,变量名或者方法名里的英文单词缩写,比如 query 写成 qry

2020-03-26 21:39:21 +08:00
 AllenHua

这样的例子蛮多

query 写成 qry

button 写成 btn

history 写成 his

service 写成 serv

parameter 写成 param params

select 写成 sel (如果写全 selected 使用过去式还能表达出状态信息 一举多得)

modify 写成 mod

类似的挺多的,不可否认 大家都很清楚的而且单词长度很长的更推荐简写,(不过这个 「大家都清楚」 界限又不太好确定)

然而有些单词实在是冷门,却还要简写成两三个字母。接手其他人代码的那个兄弟可能会爆炸,如果他们的编码习惯,命名习惯很不相同……

这个 topic 似乎也有代码规范制约着,想问问大家的看法?

8307 次点击
所在节点    程序员
88 条回复
skylancer
2020-03-26 22:18:32 +08:00
这没啥好担心的,唯一的问题是,请养成写注释的好习惯
veike
2020-03-26 22:20:16 +08:00
我一般都写的特别长
Rwing
2020-03-26 22:23:37 +08:00
全部不要缩写
AllenHua
2020-03-26 23:03:06 +08:00
@Mohanson #11 你把你狗头丢掉了 🐻dei [滑稽]
AllenHua
2020-03-26 23:06:26 +08:00
@Pythondr #17 我也认为尽量讲究具体 讲究严格严谨
@crella #19 还是要英文喔
@autoxbc #20 哥们的序号用法很标准 很规范 好评
@veike #22 见名知义 最好了
@Rwing #23 文件体积大了 也要想办法压缩 必要时还是要考虑缩写的
U7Q5tLAex2FI0o0g
2020-03-26 23:08:23 +08:00
通用的常见的缩写完全没问题,写代码的都看得懂吧:
button btn
request req
response res
parameter param
temp tmp

不过 history -> his ????
strawberryBug
2020-03-26 23:58:04 +08:00
@littleylv lol,干脆全部不要缩写
HENQIGUAI
2020-03-27 00:01:40 +08:00
多打几个字母会死么?自动补全也并不需要你多打几下啊

自己造什么玩意缩写,不是业界通用的缩写就老老实实的写全
hszhakka2ex
2020-03-27 00:03:30 +08:00
不缩写,易懂,不用猜。
AllenHua
2020-03-27 00:04:34 +08:00
@littleylv 我真见过 把 history 写成 his 的代码
wangyzj
2020-03-27 00:15:52 +08:00
baobao1270
2020-03-27 00:18:54 +08:00
param, btn, serv/srv, 可以接受
我认为应当在团队中设定一个允许的缩写列表,列表之外的都不可以缩写。
IgniteWhite
2020-03-27 00:24:28 +08:00
很多集成电路的选择线都叫 sel,这个倒是通用
params 和 arg 一样,类 unix 常见
mod 这个倒的确应该说清楚
randyo
2020-03-27 00:26:26 +08:00
手工混淆吗
hoyixi
2020-03-27 00:26:56 +08:00
btn param 至少不会引起歧义

这东西乱写的话,纯粹给自己和团队埋雷,时间长了恐怕就忘了
hanxiV2EX
2020-03-27 00:27:25 +08:00
用拼音挺好的
ericls
2020-03-27 00:54:40 +08:00
bikeshedding
Felldeadbird
2020-03-27 01:09:01 +08:00
不是所有单词都合适缩写…
stillsilly
2020-03-27 01:18:49 +08:00
古代程序员喜欢这么干
learningman
2020-03-27 01:20:35 +08:00
@ostrichb receive Response (确信)

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/656551

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX