对接群里看到别的公司发的代码截图，有点绷不住

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

• 请不要在回答技术问题时复制粘贴 AI 生成的内容

这是一个创建于 370 天前的主题，其中的信息可能已经有所发展或是发生改变。

结构体名用中文

变量名用拼音和英文混合

哪怕都用拼英也统一风格呀，要么都缩写要么都全写。。

注释抄的文档的，不是他自己写的。。

最后配上 360

第 1 条附言 · 2024-07-30 17:17:21 +08:00

特地找了一下文档内容：

有个沙雕说多人修改。显然这是单人对着文档的结果。
有个沙雕说细化了 int8 int16 已经很照顾你了。因为文档写明数据类型了，而且需要二进制解析。

赞同的那些人，祝你们同事们全都写 FDJZSpeed 风格代码。

我没有说中文或者拼英不好。我强调了，需要统一风格，我们组里的一些代码都是拼英缩写早已习惯。

我看到这图的第一反应就是，还好这人不是我同事，仅此而已。

风格

注释

截图

174 条回复 • 2024-08-01 18:00:44 +08:00

1 2

❮

❯

q8515620

2024-07-30 16:38:06 +08:00 via Android

哈哈哈哈哈哈

jstony

2024-07-30 16:38:25 +08:00

以后都是 ai 编程，ai 能看懂就行了，人不需要看懂，哈哈

kxg3030

2024-07-30 16:39:42 +08:00

为什么我看图片都是损坏的

xcsoft

2024-07-30 16:41:39 +08:00

这该不会是易语言写多了吧哈哈哈哈

9136347

2024-07-30 16:42:47 +08:00

提个建议，在 json 内的 key 名可以用下划线吗？我一直认为在数据传递的过程中，用小写加下划线比驼峰舒服。

maxwellz

2024-07-30 16:43:05 +08:00

这...写的，能跑就行🙏

retrocode

2024-07-30 16:43:47 +08:00

可以了, 至少看着规整都是大驼峰, 命名风格明显是不同老哥在不同时期加的, JD, WD 应该是最长用到的, 可能到处都是于是老哥起了个短的, 剩下的英文/拼音/拼音加英文/拼音首字母缩写混用一般都是不同人不同时期挨个加上去的.

看情况, 这应该是内部沟通对象, 那属性也有可能是其他早期接口传回来的导致一直沿用下来也不一定.

槽点不大, 至少都有注释了, 可以了真的. 至于 360 有啥吐槽的, 功能全面简单好用论安全性秒火绒几条街, 都程序员了还驯服不了那几个广告?

Vegetable

2024-07-30 16:45:44 +08:00

除了发动机转速有点难绷，其他都可以接受

shadowyue

2024-07-30 16:46:59 +08:00

超复杂的业务名称你们是怎么命名的？翻译成英文好长一段又不知道翻译的好不好。拼音感觉也不太行。
搞得我有时候都放弃了，直接一串中文。。。。

比如近 30 天目标分成基数，近三个月分成金额趋势

maxwellz

2024-07-30 16:49:15 +08:00

哦，还缺英文单词拼写错误，不然就齐活了

Jesens

2024-07-30 16:49:19 +08:00

我感觉还好，因为翻译成英文会很长

yanyao233

2024-07-30 16:51:57 +08:00 via Android

有中文注释就偷着乐吧，下回直接不给你加注释🤣

madku

2024-07-30 16:54:03 +08:00

注释很详细

HappyAndSmile

2024-07-30 16:54:04 +08:00

这种偏向业务的不好用一长串英语命名变量，用中文其实是可取的，反而减少误解和沟通成本

fugu37

2024-07-30 16:54:48 +08:00

@shadowyue #9

拼音、缩写、汉字都可以，强行翻译是最差的选择（有外国员工另说）

gerefoxing

2024-07-30 16:56:34 +08:00

会计、财务、税务业务那些字段有些用英文名就很长，基本都是用拼音

jrqlxue

2024-07-30 16:56:36 +08:00

golang 其实可以直接中文变量名的，用拼音和英文你们很照顾了..

另外，用 int32 int16 uint8 uint16 而不是直接 int 很细致了，不清楚是不是要嵌入式/物联网对内存有更高的控制要求

billbur

2024-07-30 16:59:41 +08:00

@shadowyue 缩写+注释，不得不相信就算翻译的再怎么专业，也会有很多人看不懂的

CodeCodeStudy

2024-07-30 17:00:30 +08:00

发动机转速，FDJZSpeed ，有点绷不住，用 EngineSpeed 不就好了，或者 FDJZS

shenyiyouge

2024-07-30 17:01:59 +08:00

@raviscioniemeche 我也是，感觉是梯子问题..

morty0

2024-07-30 17:02:57 +08:00

@shadowyue 分层, 目标分成基数.30 天, 分成金额趋势.近三个月

ZX16815

2024-07-30 17:04:34 +08:00

不重要，不考虑场景的规约狗屁不是。还有些规约属于是制定者的自嗨，更加不必理会

tallest

2024-07-30 17:05:54 +08:00

我觉得抽象的是那个中文的结构体名字

lisxour

2024-07-30 17:12:46 +08:00

@shadowyue 实在不行，中文是没有任何问题的，最绷不住的就是那种拼音夹英语的。。。

dupenn

2024-07-30 17:17:21 +08:00

知足吧，我这还有使用中文拼音的第一个字母的，我想破脑袋也不知道他这个名称是啥意思

ouou0701

2024-07-30 17:19:23 +08:00

我之前的同事写了个我绷不住的变量名 kuaisuRecharge 拼音+英文组合

ovtfkw

2024-07-30 17:20:20 +08:00 via iPhone

能跑就行，激动个啥

beneo

2024-07-30 17:20:50 +08:00

这是一个故事的开始，讨厌“他”，理解“他”，成为“他”

q8515620

2024-07-30 17:22:02 +08:00 via Android

@maxwellz 还真有哦，KGSigal 开关量信号

Huelse

2024-07-30 17:24:40 +08:00

还在用个 360 加速球确实有点崩不住

hhhh115

2024-07-30 17:24:55 +08:00

有注释就该烧香了

jadehare

2024-07-30 17:25:27 +08:00

这结构命名确实难绷

cutecore

2024-07-30 17:34:20 +08:00

我们直接中文枚举

ChainLock

2024-07-30 17:37:05 +08:00

优雅

ChainLock

2024-07-30 17:38:40 +08:00

我知道这并不好笑，但是我实在忍不住啊

yelc668

2024-07-30 17:39:12 +08:00

出来赚钱而已,那能有那么多要求,能正常发工资就阿弥陀佛了

kanepan19

2024-07-30 17:40:54 +08:00

能跑就行，大家都是混工资的

tool2dx

2024-07-30 17:42:13 +08:00

我拼音不好，起变量名，要么英文要么中文。拼音有歧义，实在不好猜。

比如"周边车牌号"等于 surrounding_license_plate_numbers, 名字长点就长点，反正用的不多。

ShareDuck

2024-07-30 17:59:09 +08:00

只要不用拼音缩写，其他的我都能接受。用中文没什么问题，不过前提是不要使用不支持中文的工具就好。

sagaxu

2024-07-30 18:01:36 +08:00

见过字段名全部用 ABC+数字后缀的，数据库表名字段名也是这样，问就是增加第三方二次开发成本，更有机会拿到后续项目

a1562619919

2024-07-30 18:22:14 +08:00 via Android

写代码不是为了写出让所有人都满意的代码，而是写出自己能看懂的代码

noahlias

2024-07-30 18:37:36 +08:00

缩写加英文+中文拼音混合大杂烩
哈哈

gnahzraensim

2024-07-30 18:54:50 +08:00

部标? 现在都发展到什么版本了 ?

Tanix2

2024-07-30 19:02:15 +08:00

这种专业领域纯中文挺好的

shijingshijing

2024-07-30 19:05:16 +08:00

@q8515620 仅有的英文信号 Signal 还拼错了。。。

byzod

2024-07-30 19:10:26 +08:00

就这，你要是去实体行业看看那些野路子工程师自己搓的小程序
保证什么低血压低血糖全给治好了

XFLx2

2024-07-30 19:37:52 +08:00

只说 2 个字：震惊

kran

2024-07-30 19:41:20 +08:00 via Android

曾经做过一个人效系统，最终决定变量名使用中文。最简单便捷容易理解。

seeu2ex

2024-07-30 19:43:55 +08:00 via iPhone

英文缩写不知道咋整

lambdaq

2024-07-30 19:44:35 +08:00

英语、拼音、混搭，我都能接受

我不能接受英语拼写错误，拼音平翘舌搞错，缩写把顺序写颠倒这种。。。太尼玛蛋痛了。。。。

shijingshijing

2024-07-30 20:02:22 +08:00

你把它理解成防御性编程的一种是不是就不会那么难受了？

mark2025

2024-07-30 20:07:00 +08:00

@HappyAndSmile 是的，尤其是财务、库存场景，用英文、缩写、拼音都很麻烦，还是中文简洁明了～

aliveyang

2024-07-30 20:07:59 +08:00

有注释的话我感觉还行

dji38838c

2024-07-30 20:12:10 +08:00

这是因为英文词汇有限
只能这样了

Arthit

2024-07-30 20:21:18 +08:00

我还见碰见过把中文当字段名名呢

Lynntox

2024-07-30 20:59:10 +08:00

我感觉已经可以了又没有乱七八糟的

RoccoShi

2024-07-30 21:05:34 +08:00

FDJZSpeed 有点难绷哈哈哈

Abbeyok

2024-07-30 21:07:40 +08:00

拼音加英文确实有点难绷，但是起码写了备注

needpp

2024-07-30 21:18:56 +08:00

哈哈，cache [擦车] 来了

hiboshi

2024-07-30 21:55:28 +08:00

这重要么？有时候业务就是很难起名字，强行用英文有时候真的不合适。

danisadreamer

2024-07-30 22:07:49 +08:00 via iPhone

有没有一种可能，这个是工具自动生成的，配置里的结构体名字就叫这个

netabare

2024-07-30 23:11:00 +08:00 via iPhone

头一回见到把类型、参数名和注释垂直对齐的格式，这种格式要是稍微改个参数名感觉要维护起来会很难受

luodan

2024-07-30 23:17:01 +08:00

纯英文: Height, 纯拼音: RanLiaoXiaoHao, 拼音首字母: JD, 英文+拼音: JiaSuTaBanAddr, 英文+拼音首字母: FDJZSpeed, 拼音+英文首字母: LPNZhouBian 。真是叹为观止！叫这哥们努努力，加上“英文首字母”和“英文首字母+拼音首字母”两种方式，8 种命名的排列组合就齐了。

mingtdlb

2024-07-30 23:24:09 +08:00

我主张能跑起来，且稳定，没毛病就行

Ackvincent

2024-07-30 23:35:03 +08:00

大家都在摸鱼，差不多就行了。

ivvei

2024-07-30 23:44:46 +08:00

过于离谱，叹为观止。特别是 FDJZSpeed ，真的不是来搞笑的么…… 转都出来了，速居然成了英文

suyuyu

2024-07-30 23:56:54 +08:00

我同事很僵硬的机翻嘲笑我拼音

kkk9

2024-07-31 00:07:08 +08:00

@xcsoft #4 哈哈哈写过易语言的人觉得卧槽是青春啊！

laofan666

2024-07-31 00:21:20 +08:00 via iPhone

不好翻译的情况下起中文名没毛病

vvhy

2024-07-31 00:22:46 +08:00

FDJZSpeed 这个实在绷不住哈哈哈哈

NewMoorj

2024-07-31 03:19:34 +08:00

别笑，这不就是有些人推崇的增加维护难度吗？只有自己能看懂，可以增加自己的不可替代性。

坛里经常这样，教别人如何不可替代，自己遇到了又要骂的。

jadec0der

2024-07-31 05:35:10 +08:00

我觉得最绷不住的是 KGSigal 开关信号

Signal 还是错的

gesse

2024-07-31 07:43:54 +08:00

嘲笑的都是在互联网公司待习惯的或者毕业没几个年头的

不嘲笑或者一笑而过的都是基层经验丰富、贴近生产生活的

ZGame

2024-07-31 08:07:43 +08:00

有注释就挺好的我感觉要么全中文要么英文会好点

noahlias

2024-07-31 08:22:30 +08:00

@gesse 什么刻板印象
讲道理这种命名的我的刻板印象是那种培训班的
就是没有一定的基础教育+速成导致的
连基本的 code style 一致性都没有可想有多混乱

shoco

2024-07-31 08:25:21 +08:00

命名三个原则，1. 易理解； 2. 免记忆； 3. 好用。所以缩写前缀加中文是相当适用的。

enaxm

2024-07-31 08:30:57 +08:00

谁管这个，很多都是以前留下来的，开发离职了好几个了，改啥

dbpe

2024-07-31 08:53:38 +08:00

我觉得没什么问题..最终是要服务到人的..人舒服就好了..如果组内都是这种...你换个英文的...emmm..

zhangeric

2024-07-31 09:07:28 +08:00

有注释能看懂就行了,可能人公司就是这么规定得.看不惯,你大不了自己再转一下呗.

asasjajsajsd

2024-07-31 09:10:17 +08:00

一些专业名词用拼音缩写很正常的，因为专业名词一大坨

uiosun

2024-07-31 09:11:36 +08:00

kuaidi_hundred……至今觉得很强！第一眼看过去，以为是英文，仔细一看，有点英文，但不多

duanxianze

2024-07-31 09:17:17 +08:00

哈哈哈哈，其实挺好了，有注释就行

gpt5

2024-07-31 09:18:05 +08:00

挺好的，jd,wd 比 latitude ，longitude 好写多了

X0V0X

2024-07-31 09:18:42 +08:00 via iPhone

360 加速球才是亮点

codingKingKong

2024-07-31 09:19:11 +08:00

你猜我为什么笑不出来, 我正在接手一个项目...

jwj

2024-07-31 09:19:39 +08:00

对接过 GPS ，命名命烦了，直接 a-z

leinad59

2024-07-31 09:20:18 +08:00

吐槽理解。
但不明白为什么用“有个沙雕”来攻击楼下。

ethangogogo

2024-07-31 09:21:05 +08:00

只有我觉得甚至有点恐怖吗，看起来像是什么汽车相关的，安全性堪忧

silentCM

2024-07-31 09:22:57 +08:00

我之前做一个政府的公积金的项目他们也是这样写的，数据库字段命名，代码里面都是拼音首字母大写，我根本不知道什么意思。

Znemo

2024-07-31 09:24:12 +08:00

不是为这种代码辩解，确实专业名词太多，被迫用有限的词汇量去描述大千世界 😂 有的时候使用拼音可能要比使用了错误的单词好些。

Narcissu5

2024-07-31 09:25:35 +08:00

中文比拼音缩写好，拼音缩写就跟脸滚键盘滚出来的一样。还有有些中文名字，翻成英文真的就翻不回来了

yooomu

2024-07-31 09:27:27 +08:00

@jrqlxue #17 这个估计是 golang 结构体与字节数组用 binary 包序列化和反序列化的强制要求，类型需要是有明确长度的。看物联网场景与硬件交互估计免不了这个

misaka20

2024-07-31 09:28:05 +08:00

单看这部分代码，命名差强人意，但整体看起来比强行用英文命名的好理解的多。

abelmakihara

2024-07-31 09:28:48 +08:00

@lambdaq 我也最讨厌这种人典型的糊弄加不专业常见单词都能拼错我很怀疑这种人的工作能力

cominghome

2024-07-31 09:30:52 +08:00

能看懂就行，我反正觉得问题不大。

专业英语还是有点门槛的，非日常用词第一时间想不起来直接用拼音替代并不是什么丑事（有些单词用的人第一时间想不起来读的人没准也没法顺利读通）

2xvaHoK2LGxQ29R5

2024-07-31 09:32:01 +08:00 via Android

想想看这代码要放在你的车上的话有点怕怕的

cominghome

2024-07-31 09:34:40 +08:00

@noahlias
你这难道不是刻板印象？说白了还是见识少，让你去对接几个 ERP 或者财会系统你就老实了

tomatocici2333

2024-07-31 09:35:45 +08:00

@silentCM 这种都有字典表的其实还好

noahlias

2024-07-31 09:40:38 +08:00

@cominghome 我说了呀我是刻板印象对他的刻板印象啊
你说的这个我又不是没见过中国银行业务系统里面的大部分都是这种
见怪不怪了（我只是反击别人的刻板印象

100

cF06myaQ57WHKMBv

2024-07-31 09:43:03 +08:00

我感觉没啥问题，简单明了，好理解，好沟通。竟然这么多人觉得不合理... 那么 OP 觉得应该怎么命名呢，能否重命名一下，提供个示例？各路大神也可以重命名下

1 2

❮

❯