嘿，大家好。今天我们来聊聊一个很吓人的事情，就是写代码。写代码这事儿吧，说简单也简单，说难也难。很多人觉得只要能跑起来就行，比如那个变量名叫个a、b、c，或者把代码挤成一团，能运行不报错就行了。但是我想说如果你是软件工程师，要么不写代码，要么就写优雅的代码。这是底线。不然你写的那些垃圾代码，过了一个月你自己都看不懂，更别说给别人看了。今天我们邀请了4名淘系技术工程师，他们说要结合自己的感受，给大家分享怎么写才好。其实也就是怎么别把事情搞砸，公正地讲...。

第一部分：逻辑是代码的产物， 别把脑子丢在床上

我破防了。 先说说我们要明白一个很严肃的事情，逻辑清晰：代码是逻辑的产物。这句话听起来很对，但是很多人就是做不到。编写代码的时候，业务相关的逻辑一定要清晰明确，不能模棱两可。比如你要做一个加法，后来啊是多少？你心里得有数。但是现实是很多人写代码的时候，根本不知道自己在干嘛，就像无头苍蝇一样乱撞。

我可是吃过亏的。 除此之外 对于所定义的变量、代码块、数据结构、方法、类、模块等，也要有逻辑地组织它们。这个很重要。你不能把你的硬盘砸烂了再找文件，代码也是一样。如果你把所有东西都混在一起，那叫混乱，不叫代码。

太顶了。 但是这不意味着可以不写注释。别急着反驳我。我说的是当通过代码如果无法表达意思的时候，就需要注释。比如如下代码， 这种写虽然可以但是当字段的多的时候，光校验就占据了很长的代码不够优雅。这时候你就得说话了用注释告诉别人你在干嘛。

if  {
    // 这个人是活着的
    // 这个人的年龄是有效的
    // ...
}

冲鸭！ 你看，这样是不是清楚多了？虽然有点废话，但是比看不懂强。

1.1 异常处理：别让程序崩了但也别挡着阳光

有时候try catch代码有时会干扰我们阅读核心的代码逻辑。比如你写了一堆复杂的算法， 后来啊中间有个try-catch把核心逻辑给包起来了你根本看不到里面发生了什么。这时候就可以把try catch内部主逻辑抽离成一个单独的方法。这样主流程看起来就清爽多了。

乱弹琴。 * **提醒** : 全局变量会让代码难以追踪和测试。真的，千万别用全局变量。你定义了一个变量，然后在文件的这头用了在另一头又改了你自己都不知道哪一步把它改了。测试的时候也麻烦，主要原因是你不知道它被谁改了。

第二部分：严谨可靠， 别做Bug制造机

一份代码即使严格遵守了代码规范，但思考不全面逻辑不严谨，到处都是各种漏洞和bug，也不能称之为优雅。 这话很扎心，但是是实话。优雅的代码，先说说是靠谱的。

严谨的代码，才能保证它的可靠性，减少bug的发生几率。这一点比什么都重要。但是很多人就是不爱思考，写完就跑，报错了再改。这叫什么？这叫娱乐。

2.1 单元测试：虽然烦，但是必须得写

* **实践** : 为关键功能编写单元测试,确保代码质量。我知道很多人讨厌单元测试，觉得写测试比写功能还累。 太刺激了。 但是为了防止你改了一个功能把整个系统搞崩了你还是得写。哪怕只写几个关键的case。

第三部分：命名、注释与编辑器的爱恨情仇

今天我们邀请了 4 名淘系技术工程师,结合他们自身在写码过程中的感受,给大家分享一些他们对于优雅代码的理解和具体写作方式,希望能够对你有帮助，这玩意儿...。

这里的易懂不是意味着加注释 如果一段代码开发者感觉需要加注释那说明它本身就不易理解了可以考虑优化。这是原则。但是现实往往很骨感。比如Arm汇编语言的源代码文件。这些文件通常用于嵌入式系统和嵌入式软件开发中。这里面有很多注释用于解释和说明代码的功能和逻辑。 哈基米！ Arm .list文件通常包含以下内容：汇编指令， 用于施行特定的操作和计算；数据定义，包括变量和常量的定义；注释用于解释和说明代码的功能和逻辑。Arm .list文件可以使用文本编辑器打开和修改。

好，扯远了。回到正题。命名是很严肃的事。大到项目名、 包名、类名，小到方法名、变量名、参数名，甚至是一个临时变量的名称，其命名都是很严肃的事,好的命名能让你少写很多注释。

3.1 为什么命名这么难？

大多数开发者停在 能跑 的层面——变量名用a/b/c,代码挤成一团,注释要么写满废话要么啥都不写 再说说自己写的代码过一个月都看不懂， 不地道。 更别说团队协作了。这太正常了。但是我们还是要追求卓越。

这种命名方式有助于按顺序阅读和理解代码的逻辑流程。比如你看到 `calculateTotalPrice`，你就知道这是算总价的。如果你看到 `calc`，你还得去猜。猜是很累的，你想...。

3.2 编辑器：你的娱乐大脑

用户对代码编辑器的需求远远超出了基本的文本编辑功能,它们期望编辑器能够提供强大的代码理解能力,优雅的用户界面,以及流畅的编辑体验。现在的编辑器都很智能。编辑器分析当前代码上下文中的关键字、变量名和代码结构,然后根据这些信息提供适当的代码建议。这能帮你少打很多字。如果开发者犯了语法或逻辑错误,编辑器会立刻提供修正建议。这很好，但是别太依赖它，哈基米！。

第四部分：代码规范与

我emo了。 严格地遵守代码规范,是提高且保证代码质量的最有效方法。，一份良好...的代码规范，能让你活得更久。

地道。 步骤,应添加行内注释进行解释。这种命名方式有助于按顺序阅读和理解代码的逻辑流程。

软件工程师有一大箩筐的借口来娱乐提升代码质量的要求,更不用说还要编写优雅的代码了。比如“来不及了”、“客户催了”、“这只是一个Demo”。借口。全是借口，我不敢苟同...。

4.1 实际操作中的小技巧

1. 逻辑清晰别把简单的事情搞复杂。代码是写给机器看的，也是写给未来的自己看的。

搞起来。 2. 注释适度能从名字看懂的别注释。只有当逻辑特别绕的时候才注释。

3. 异常处理别到处try-catch。抽离出来单独处理。

太坑了。 4. 单元测试写了测试，你才有底气重构。

5. 命名规范见名知意。别用a、b、c。

优雅的代码不是一蹴而就的。它需要你在每一次敲击键盘的时候都思考一下：这样写好不好？这样写能不能让人看懂？虽然很难，但是为了以后不加班改Bug，还是值得的，干就完了！。

再说说 提醒大家一下Rust这个语言，每当一个变量被赋予一个值时,Rust会确定这个变量是否 拥有 这个值,拥有资源的变量负责在适当的时候释放这些资源。 精神内耗。 模块系统允许我们将相关的函数、类型、常量等组织在一起,形成一个逻辑上的单元。这也是一种优雅的体现。

切中要害。 好了就说这么多。希望你们能写出既高效又优雅的代码。如果不优雅，至少别太烂。谢谢大家。