From 08e116279ad8ea586fd44e6564dcf06679f4cec9 Mon Sep 17 00:00:00 2001 From: Xingyu Wang Date: Fri, 27 Dec 2019 09:17:01 +0800 Subject: [PATCH] PRF MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit @HankChow 翻译的很好！ --- ...code needs to be beautiful and explicit.md | 26 +++++++++++-------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/translated/tech/20191222 Why your Python code needs to be beautiful and explicit.md b/translated/tech/20191222 Why your Python code needs to be beautiful and explicit.md index ae5568bd13..747efed262 100644 --- a/translated/tech/20191222 Why your Python code needs to be beautiful and explicit.md +++ b/translated/tech/20191222 Why your Python code needs to be beautiful and explicit.md @@ -1,6 +1,6 @@ [#]: collector: (lujun9972) [#]: translator: (HankChow) -[#]: reviewer: ( ) +[#]: reviewer: (wxy) [#]: publisher: ( ) [#]: url: ( ) [#]: subject: (Why your Python code needs to be beautiful and explicit) @@ -9,18 +9,22 @@ 为什么 Python 代码要写得美观而明确 ====== -欢迎阅读“Python 光明节（Pythonukkah）”系列文章，这个系列文章将会讨论《Python 之禅》。我们首先来看《Python 之禅》里的前两个原则：美观与明确。 -![Searching for code][1] -早在 1999 年，Python 的贡献者之一，Tim Peters 就提出了《[Python 之禅][2]》，直到二十年后的今天，《Python 之禅》中的 19 条原则仍然对整个社区都产生着深远的影响。为此，我们举行了这一次的“Python 光明节”。首先，我们会讨论《Python 之禅》中的前两个原则：美观和明确。 +> 欢迎阅读“Python 光明节（Pythonukkah）”系列文章，这个系列文章将会讨论《Python 之禅》。我们首先来看《Python 之禅》里的前两个原则：美观与明确。 -> "Hanukkah is the Festival of Lights, -> Instead of one day of presents, we get eight crazy nights." -> —亚当·桑德勒, [光明节之歌][3] +![](https://img.linux.net.cn/data/attachment/album/201912/27/091634drq96c2fojzp6okr.png) + +早在 1999 年，Python 的贡献者之一，Tim Peters 就提出了《[Python 之禅][2]》，直到二十年后的今天，《Python 之禅》中的 19 条原则仍然对整个社区都产生着深远的影响。为此，就像庆典光明的光明节Hanukkah一样，我们举行了这一次的“Python 光明节Pythonukkah”。首先，我们会讨论《Python 之禅》中的前两个原则：美观和明确。 + +> “Hanukkah is the Festival of Lights, +> +> Instead of one day of presents, we get eight crazy nights.” +> +> —亚当·桑德勒，[光明节之歌][3] ### 美观胜于丑陋 -著名的《[计算机程序的构造和解释Structure and Interpretation of Computer Programs][4]》中有这么一句话：代码是写给人看的，只是恰好能让机器运行（Programs must be written for people to read and only incidentally for machines to execute.）。毕竟机器并不在乎代码的美观性，但人类在乎。 +著名的《[计算机程序的构造和解释Structure and Interpretation of Computer Programs][4]》中有这么一句话：代码是写给人看的，只是恰好能让机器运行。Programs must be written for people to read and only incidentally for machines to execute.机器并不在乎代码的美观性，但人类在乎。 阅读美观的代码对人们来说是一种享受，这就要求在整套代码中保持一致的风格。使用诸如 [Black][5]、[flake8][6]、[Pylint][7] 这一类工具能够有效地接近这一个目标。 @@ -28,7 +32,7 @@ 最后，个人的主观能动性也很重要，否则一切工具和流程都会变得毫无意义。只有意识到美观的重要性，才能主动编写出美观的代码。 -这就是为什么美观在众多原则当中排到了首位，它让“美”成为了 Python 社区的一种价值。如果有人要问，”我们真的在乎美吗？“社区会以代码给出肯定的答案。 +这就是为什么美观在众多原则当中排到了首位，它让“美”成为了 Python 社区的一种价值。如果有人要问，”我们*真的*在乎美吗？“社区会以代码给出肯定的答案。 ### 明确胜于隐晦 @@ -38,7 +42,7 @@ 这个问题已经是老生常谈了，但网络上很多流传已久的回答都是不准确的。在编写元类metaclass时，显式指定 `self` 参数就显得毫无意义。如果你没有编写过元类，希望你可以尝试一下，这是很多 Python 程序员的必经之路。 -显式指定 `self` 参数的原因并不是 Python 的设计者不想将这样的元类视为“默认”元类，而是因为第一个参数必须是显式的。 +显式指定 `self` 参数的原因并不是 Python 的设计者不想将这样的元类视为“默认”元类，而是因为第一个参数必须是*显式*的。 即使 Python 中确实允许非显式的情况存在（例如上下文变量），但我们还是应该提出疑问：某个东西是不是有存在的必要呢？如果非显式地传递参数会不会出现问题呢？有些时候，由于种种原因，这是会有问题的。总之，在写代码时一旦能够优先考虑到明确性，至少意味着能对不明确的地方提出疑问并对结果作出有效的估计。 @@ -49,7 +53,7 @@ via: https://opensource.com/article/19/12/zen-python-beauty-clarity 作者：[Moshe Zadka][a] 选题：[lujun9972][b] 译者：[HankChow](https://github.com/HankChow) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出