2 Python 语言规则#

2 Python Language Rules

2.3 包#

2.3 Packages

中文

使用模块的完整路径名位置导入每个模块。

英文

Import each module using the full pathname location of the module.

2.3.1 优点#

2.3.1 Pros

中文

避免由于模块搜索路径不符合作者预期而导致模块名称冲突或导入错误。使模块查找更加便捷。

英文

Avoids conflicts in module names or incorrect imports due to the module search path not being what the author expected. Makes it easier to find modules.

2.3.2 缺点#

2.3.2 Cons

中文

由于必须复制包的层次结构，代码部署会变得更加困难。对于现代部署机制来说，这并非什么问题。

英文

Makes it harder to deploy code because you have to replicate the package hierarchy. Not really a problem with modern deployment mechanisms.

2.3.3 决策#

2.3.3 Decision

中文

所有新代码都应通过完整的包名称导入模块。

导入语句应如下所示：

Yes:
# 在代码中通过完整名称引用 absl.flags（较为冗长但清晰）。
import absl.flags
from doctor.who import jodie

_FOO = absl.flags.DEFINE_string(...)

Yes:
# 在代码中仅通过模块名引用 flags（常见做法）。
from absl import flags
from doctor.who import jodie

_FOO = flags.DEFINE_string(...)

(假设该文件位于 doctor/who/ ，且 jodie.py 也在同一目录中)

No:
# 无法明确作者希望导入哪个模块，也无法确定实际会导入哪个模块。
# 实际的导入行为依赖于控制 sys.path 的外部因素。
# 作者是想导入哪个 jodie 模块？
import jodie

不应假设主程序所在目录会自动添加到 sys.path 中，尽管在某些环境中确实如此。因此，代码应默认 import jodie 指的是某个第三方或顶层包 jodie，而非本地的 jodie.py 文件。

英文

All new code should import each module by its full package name.

Imports should be as follows:

Yes:
# Reference absl.flags in code with the complete name (verbose).
import absl.flags
from doctor.who import jodie

_FOO = absl.flags.DEFINE_string(...)

Yes:
# Reference flags in code with just the module name (common).
from absl import flags
from doctor.who import jodie

_FOO = flags.DEFINE_string(...)

(assume this file lives in doctor/who/ where jodie.py also exists)

No:
# Unclear what module the author wanted and what will be imported.  The actual
# import behavior depends on external factors controlling sys.path.
# Which possible jodie module did the author intend to import?
import jodie

The directory the main binary is located in should not be assumed to be in sys.path despite that happening in some environments. This being the case, code should assume that import jodie refers to a third-party or top-level package named jodie, not a local jodie.py.

2.18 线程#

2.18 Threading

中文

不要依赖内置类型的原子性。

虽然 Python 的内置数据类型（例如字典）似乎具有原子操作，但在某些情况下它们并非原子操作（例如，如果 __hash__ 或 __eq__ 被实现为 Python 方法），则不应依赖它们的原子性。也不应该依赖原子变量赋值（因为这反过来又依赖于字典）。

使用 queue 模块的 Queue 数据类型作为线程间数据通信的首选方式。否则，请使用 threading 模块及其锁定原语。优先使用条件变量和 threading.Condition，而不是使用低级锁。

英文

Do not rely on the atomicity of built-in types.

While Python’s built-in data types such as dictionaries appear to have atomic operations, there are corner cases where they aren’t atomic (e.g. if __hash__ or __eq__ are implemented as Python methods) and their atomicity should not be relied upon. Neither should you rely on atomic variable assignment (since this in turn depends on dictionaries).

Use the queue module’s Queue data type as the preferred way to communicate data between threads. Otherwise, use the threading module and its locking primitives. Prefer condition variables and threading.Condition instead of using lower-level locks.

2 Python 语言规则#

2.1 Lint#

2.1.1 定义#

2.1.2 优点#

2.1.3 缺点#

2.1.4 决策#

2.2 导入#

2.2.1 定义#

2.2.2 优点#

2.2.3 缺点#

2.2.4 决策#

2.2.4.1 豁免#

2.3 包#

2.3.1 优点#

2.3.2 缺点#

2.3.3 决策#

2.4 异常#

2.4.1 定义#

2.4.2 优点#

2.4.3 缺点#

2.4.4 决策#

2.5 可变全局状态#

2.5.1 定义#

2.5.2 优点#

2.5.3 缺点#

2.5.4 决策#

2.6 嵌套/本地/内部类和函数#

2.6.1 定义#

2.6.2优点#

2.6.3 缺点#

2.6.4 决策#

2.7 推导式与生成器表达式#

2.7.1 定义#

2.7.2 优点#

2.7.3 缺点#

2.7.4 决策#

2.8 默认迭代器和运算符#

2.8.1 定义#

2.8.2 优点#

2.8.3 缺点#

2.8.4 决策#

2.9 生成器#

2.9.1 定义#

2.9.2 优点#

2.9.3 缺点#

2.9.4 决策#

2.10 Lambda 函数#

2.10.1 定义#

2.10.2 优点#

2.10.3 缺点#

2.10.4 决策#

2.11 条件表达式#

2.11.1 定义#

2.11.2 优点#

2.11.3 缺点#

2.11.4 决策#

2.12 默认参数值#

2.12.1 定义#

2.12.2 优点#

2.12.3 缺点#

2.12.4 决策#

2.13 属性#

2.13.1 定义#

2.13.2 优点#

2.13.3 缺点#

2.13.4 决策#

2.14 真/假判断#

2.14.1 定义#

2.14.2 优点#

2.14.3 缺点#

2.14.4 决策#

2.16 词法作用域#

2.16.1 定义#

2.16.2 优点#

2.16.3 缺点#

2.16.4 决策#

2.17 函数和方法装饰器#

2.17.1 定义#

2.17.2 优点#

2.17.3 缺点#

2.20 现代 Python：从 `future` 导入#

从 `future` 导入#