2019-12-25 21:02:12 +08:00
[#]: collector: (lujun9972)
[#]: translator: (HankChow)
2019-12-27 09:17:01 +08:00
[#]: reviewer: (wxy)
2019-12-27 09:17:39 +08:00
[#]: publisher: (wxy)
[#]: url: (https://linux.cn/article-11718-1.html)
2019-12-25 21:02:12 +08:00
[#]: subject: (Why your Python code needs to be beautiful and explicit)
[#]: via: (https://opensource.com/article/19/12/zen-python-beauty-clarity)
[#]: author: (Moshe Zadka https://opensource.com/users/moshez)
为什么 Python 代码要写得美观而明确
======
2019-12-27 09:17:01 +08:00
> 欢迎阅读“Python 光明节（ ） ，
2019-12-25 21:02:12 +08:00
2019-12-27 09:17:01 +08:00
早在 1999 年， ， ， ， < ruby > 光明节< rt > Hanukkah< / rt > < / ruby > 一样，我们举行了这一次的“< ruby > Python 光明节< rt > Pythonukkah< / rt > < / ruby > ”。首先，
> “Hanukkah is the Festival of Lights,
>
> Instead of one day of presents, we get eight crazy nights.”
>
> —亚当·桑德勒，[光明节之歌][3]
2019-12-25 21:02:12 +08:00
### 美观胜于丑陋
2019-12-27 09:17:01 +08:00
著名的《[< ruby > 计算机程序的构造和解释< rt > Structure and Interpretation of Computer Programs< / rt > < / ruby > ][4]》中有这么一句话：< ruby > 代码是写给人看的，只是恰好能让机器运行。< rt > Programs must be written for people to read and only incidentally for machines to execute.< / rt > < / ruby > 机器并不在乎代码的美观性，但人类在乎。
2019-12-25 21:02:12 +08:00
阅读美观的代码对人们来说是一种享受，这就要求在整套代码中保持一致的风格。使用诸如 [Black][5]、[flake8][6]、[Pylint][7] 这一类工具能够有效地接近这一个目标。
但实际上，只有人类自己才知道什么才是真正的美观。因此，代码审查和协同开发是其中的不二法门，同时，在开发过程中倾听别人的意见也是必不可少的。
最后，个人的主观能动性也很重要，否则一切工具和流程都会变得毫无意义。只有意识到美观的重要性，才能主动编写出美观的代码。
2019-12-27 09:17:01 +08:00
这就是为什么美观在众多原则当中排到了首位，它让“美”成为了 Python 社区的一种价值。如果有人要问，”我们*真的*在乎美吗？“社区会以代码给出肯定的答案。
2019-12-25 21:02:12 +08:00
### 明确胜于隐晦
人类会欢庆光明、惧怕黑暗，那是因为光能够让我们看到难以看清的事物。同样地，尽管有些时候我们会不自觉地把代码写得含糊不清，但明确地编写代码确实能够让我们理解很多抽象的概念。
“为什么类方法中要将 `self` 显式指定为第一个参数？”
这个问题已经是老生常谈了，但网络上很多流传已久的回答都是不准确的。在编写< ruby > 元类< rt > metaclass</ rt ></ ruby > 时，显式指定 `self` 参数就显得毫无意义。如果你没有编写过元类，希望你可以尝试一下，这是很多 Python 程序员的必经之路。
2019-12-27 09:17:01 +08:00
显式指定 `self` 参数的原因并不是 Python 的设计者不想将这样的元类视为“默认”元类，而是因为第一个参数必须是*显式*的。
2019-12-25 21:02:12 +08:00
即使 Python 中确实允许非显式的情况存在（例如上下文变量），但我们还是应该提出疑问：某个东西是不是有存在的必要呢？如果非显式地传递参数会不会出现问题呢？有些时候，由于种种原因，这是会有问题的。总之，在写代码时一旦能够优先考虑到明确性，至少意味着能对不明确的地方提出疑问并对结果作出有效的估计。
--------------------------------------------------------------------------------
via: https://opensource.com/article/19/12/zen-python-beauty-clarity
作者：[Moshe Zadka][a]
选题：[lujun9972][b]
译者：[HankChow](https://github.com/HankChow)
2019-12-27 09:17:01 +08:00
校对：[wxy](https://github.com/wxy)
2019-12-25 21:02:12 +08:00
本文由 [LCTT ](https://github.com/LCTT/TranslateProject ) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
[a]: https://opensource.com/users/moshez
[b]: https://github.com/lujun9972
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/search_find_code_python_programming.png?itok=ynSL8XRV "Searching for code"
[2]: https://www.python.org/dev/peps/pep-0020/
[3]: https://en.wikipedia.org/wiki/The_Chanukah_Song
[4]: https://en.wikipedia.org/wiki/Structure_and_Interpretation_of_Computer_Programs
[5]: https://opensource.com/article/19/5/python-black
[6]: https://opensource.com/article/19/5/python-flake8
[7]: https://opensource.com/article/19/10/python-pylint-introduction
