Google Python编码风格指南中译版:代码整洁与规范
"Python 编码风格指南中译版(Google SOC)是Google推荐的用于大、小项目维护和代码管理的Python编程规则。这份指南包括了Python语言方面的准则和编码风格方面的准则,旨在提高代码的可读性、可维护性和一致性。" 以下是这份指南中的主要知识点: 1. **概述**: - 指南涵盖了编程实践、代码结构和风格,适用于所有Python开发项目。 2. **Python语言方面的准则**: - **pychecker**: 强调使用工具如pychecker来检查代码错误和潜在问题。 - **导入模块和包**:推荐正确和清晰的导入方式,避免过多的导入和星号导入。 - **完整路径导入**:鼓励使用完整的模块路径进行导入,以提高代码可读性。 - **异常处理**:提倡使用明确的异常处理,避免使用`except Exception`等过于宽泛的异常捕获。 - **全局变量**:限制全局变量的使用,鼓励局部变量和参数传递。 - **内嵌/本地/内部类和函数**:提倡使用内联函数和类,以减少作用域污染。 - **List Comprehensions**:推荐使用列表推导式来简化代码。 - **默认迭代器和运算符**:使用内置的迭代器和操作符以提高效率。 - **生成器**:利用生成器优化内存使用,尤其在处理大量数据时。 - **apply, filter, map, reduce**:建议避免使用这些函数,转而使用列表推导或直接编写循环。 - **Lambda 函数**:适度使用,避免创建复杂的lambda表达式。 - **默认参数值**:注意默认参数的生命周期和共享,避免副作用。 - **Properties**:使用@property装饰器来封装对象的属性访问。 - **布尔内置类型**:理解如何正确使用True和False,以及它们与其他类型的互换性。 - **String方法**:了解并熟练使用字符串的各种方法,提高代码简洁性。 - **静态域**:合理使用类的静态成员,以保持代码结构清晰。 - **函数和方法修饰符**:了解和使用@staticmethod和@classmethod。 - **线程**:考虑并发和线程安全,特别是在多线程环境中。 - **高级特性**:如上下文管理器、生成器表达式、with语句等。 3. **Python编码风格方面的准则**: - **分号**:避免使用分号,除非在特定情况下需要分隔语句。 - **每行长度**:限制每行代码的字符数,通常不超过79个字符。 - **圆括号**:正确使用圆括号进行分组和创建元组。 - **缩进**:使用4个空格进行缩进,遵循PEP 8标准。 - **空行**:适当使用空行分隔代码块,增加代码可读性。 - **空格**:遵循一致的空格使用规则,如在操作符周围使用空格。 - **Python解释器**:选择合适的Python解释器版本,并保持其更新。 - **注释**:提供清晰的注释,解释代码功能和目的。 - **类**:遵循面向对象设计原则,如单一职责原则。 - **字符串**:合理使用单引号和双引号,注意字符串连接的性能。 - **TODO风格**:使用标准的TODO注释标记未完成的任务。 - **import分组及顺序**:将导入语句按标准分组,如标准库、第三方库和本地库。 - **语句**:保持语句简洁,避免过长的表达式。 - **访问控制**:使用公共、私有和保护访问修饰符。 - **命名**:遵循命名约定,如变量小驼峰,类大驼峰,常量全大写。 - **程序入口**:定义清晰的主程序入口,方便执行和测试。 - **总结**:最后,强调必须遵循这些规定,除非有充分的理由不这样做。 这份指南对于Python开发者来说是一份宝贵的资源,它帮助确保代码的高质量和一致性,同时也有助于团队间的协作和项目的长期维护。
![](https://csdnimg.cn/release/download_crawler_static/10161896/bg5.jpg)
剩余22页未读,继续阅读
![doc](https://img-home.csdnimg.cn/images/20210720083327.png)
![pdf](https://img-home.csdnimg.cn/images/20210720083512.png)
![-](https://csdnimg.cn/download_wenku/file_type_column_c1.png)
![-](https://csdnimg.cn/download_wenku/file_type_column_c1.png)
![-](https://csdnimg.cn/download_wenku/file_type_column_c1.png)
![-](https://csdnimg.cn/download_wenku/file_type_column_c1.png)
![-](https://csdnimg.cn/download_wenku/file_type_column_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/download_wenku/file_type_ask_c1.png)
![](https://csdnimg.cn/release/wenkucmsfe/public/img/green-success.6a4acb44.png)