注释
在大多数编程语言中,注释是一项很有用的功能。本书前面编写的程序都只包含 Python 代码,但随着程序越来越大、越来越复杂,就应该在其中添加说明,对你解决问题的方式进行大致的阐述。注释(comment)让你能够使用自然语言在程序中添加说明。
在 Python 中,注释用井号(#)标识。
如果有两个解决方案,一个简单、一个复杂,但都行之有效,就选择简单的解决方案。
即便是复杂的代码,也要让它易于理解。当开发的项目涉及复杂的代码时,一定要为这些代码编写有益的注释。
如果让两名 Python 程序员去解决同一个问题,他们提供的解决方案应大致相同。这并不是说编程没有创意空间,而是恰恰相反。大部分编程工作是使用常见的解决方案来解决简单的小问题,而这些小问题往往包含在更庞大、更有创意空间的项目中。在你的程序中,各种具体的细节对其他 Python 程序员来说都应该易于理解。
不要企图编写完美无缺的代码,而是要先编写行之有效的代码,再决定是对其做进一步的改进,还是转而编写新代码。