原始笔记
1.5 Python Code Style Conventions - 大纲
目录结构
- 1.5 Python Code Style Conventions(整理版)
- 内容简要概括
- 目录
- 1. PEP 8 与缩进
- 悬挂缩进
- 函数定义
- 2. 行宽与表达式换行
- 最大行宽
- 二元运算符的位置
- 3. 空行
- 顶层函数和类之间空两行
- 类中的方法之间空一行
- 函数内部少量使用空行
- 装饰器与定义之间不要空行
- 4. 空格
- 括号内部不加无意义空格
- 逗号、分号和冒号前不留空格
- 切片中的冒号
- 二元运算符
- 普通赋值中的 `=`
- 关键字参数中的 `=`
- 默认参数中的 `=`
- 5. 命名规范
- 变量:snake_case
- 函数和方法:snake_case
- 类:PascalCase
- 模块:简短、全小写
- 包:简短、全小写
- 命名速查
- 6. 注释
- Block comment:块注释
- Inline comment:行内注释
- 7. Docstring