应该避免的名称

  1. 只有单个字符的名称, 除了以下特别批准的情况:
    1. 计数器和迭代器 (例如, i, j, k, v 等等).
    2. try/except 语句中代表异常的 e.
    3. with 语句中代表文件句柄的 f.
    4. 私有的、没有约束 (constrain) 的类型变量 (type variable, 例如 _T = TypeVar("_T"), _P = ParamSpec("_P")).
  2. 包含连字符(-) 的包名/模块名.
  3. 首尾均为双下划线的名称, 例如 __double_leading_and_trailing_underscore__ (此类名称是 Python 的保留名称).
  4. 包含冒犯性词语的名称.
  5. 在不必要的情况下包含变量类型的名称 (例如 id_to_name_dict).