Python概述 Google Python 风格指南 目录 1 背景 2 Python 语言规则 2.1 Lint 2.2 导入 2.3 包 2.4 异常 2.5 可变全局状态 2.6 嵌套/局部/内部类和函数 2.7 推导式和生成器表达式 2.8 默认迭代器和运算符 2.9 生成器 2.10 Lambda 函数 2.11 条件表达式 2.12 默认参数值 2.13 属性(Properties) 2.14 True/False 求值 2.16 词法作用域 2.17 函数和方法装饰器 2.18 线程 2.19 高级特性 2.20 现代 Python: from __future__ imports 2.21 类型注解代码 3 Python 风格规则 3.1 分号 3.2 行长度 3.3 圆括号 3.4 缩进 3.4.1 序列项的尾部逗号? 3.5 空行 3.6 空格 3.7 Shebang 行 3.8 注释和文档字符串 3.8.1 文档字符串(Docstrings) 3.8.2 模块 3.8.2.1 测试模块 3.8.3 函数和方法 3.8.3.1 重写方法 3.8.4 类 3.8.5 块注释和行内注释 3.8.6 标点、拼写和语法 3.10 字符串 3.10.1 日志 3.10.2 错误消息 3.11 文件、套接字及类似有状态资源 3.12 TODO 注释 3.13 导入格式 3.14 语句 3.15 Getter 和 Setter 3.16 命名 3.16.1 应避免的名称 3.16.2 命名约定 3.16.3 文件命名 3.16.4 源自 Guido 建议的准则 3.16.5 数学符号 3.17 Main 3.18 函数长度 3.19 类型注解 3.19.1 通用规则 3.19.2 换行 3.19.3 前向声明 3.19.4 默认值 3.19.5 NoneType 3.19.6 类型别名 3.19.7 忽略类型 3.19.8 类型变量标注 3.19.9 元组 vs 列表 3.19.10 类型变量(TypeVar) 3.19.11 字符串类型 3.19.12 用于类型标注的导入 3.19.13 条件导入 3.19.14 循环依赖 3.19.15 泛型 3.19.16 构建依赖 4 结语 Last updated on March 31, 2026策略1 背景