字典的单数或复数标识符？

Question

命名容器时，什么是更好的编码风格：

source = {}
#...
source[record] = some_file

或者

sources = {}
#...
sources[record] = some_file

复数在创建时读起来更自然；赋值时的单数。

这不是一个无聊的问题；当我不确定变量是容器还是单个值时，我确实发现自己对旧代码感到困惑。

更新

似乎有一个普遍的共识，即当字典用作映射时，最好使用更详细的名称（例如，recordToSourceFilename）；如果我绝对想使用短名称，则将其设为复数（例如，sources）。

Answer 1

我认为字典有两个非常具体的用例，应该单独识别。然而，在解决它们之前，应该注意的是，字典的变量名几乎总是单数，而列表几乎总是复数。

1. 作为类对象实体的字典： 有时您有一个代表某种类对象数据结构的字典。在这些情况下，字典几乎总是指单个类似对象的数据结构，因此应该是单数的。例如：

    # 假设 users 是从某个 JSON 源解析的用户列表
    # 假设每个用户都是一个字典，包含该用户的信息
   
    对于用户中的用户：
        打印用户['姓名']
   

2. 字典作为映射实体：其他时候，你的字典可能表现得更像一个典型的哈希映射。在这种情况下，最好使用更直接的名称，但仍然是单数。例如：

   # 假设 idToUser 是一个将 ID 映射到用户对象的字典
   
   用户 = idToUser['0001a']
   打印用户名
   

3. 列表：最后，您有了列表，这是一个完全独立的想法。这些几乎总是复数，因为它们是其他实体的简单集合。例如：

   users = [userA, userB, userC] # 有意义
   对于用户中的用户：
       print user.name # 尤其是稍后，在迭代中
   

我确信有一些晦涩或不太可能的情况可能需要在这里做出一些例外，但我认为这是命名字典和列表时需要遵循的一个非常强有力的指导原则，不仅在Python中，而且在Python中也是如此。所有语言。

Answer 2

它应该是复数，因为这样程序的行为就像您大声朗读一样。让我向您展示为什么它不应该是单数（完全人为的示例）：

c = Customer(name = "Tony")
c.persist()

[...]

#
# 500 LOC later, you retrieve the customer list as a mapping from
# customer ID to Customer instance.
#

# Singular
customer = fetchCustomerList()
nameOfFirstCustomer = customer[0].name
for c in customer: # obviously it's totally confusing once you iterate
    ...

# Plural
customers = fetchCustomerList()
nameOfFirstCustomer = customers[0].name    
for customer in customers: # yeah, that makes sense!!
    ...

此外，有时最好有更明确的名称，您可以从中推断出映射（对于字典）以及可能的类型。我通常在引入字典变量时添加一个简单的注释。一个例子：

# Customer ID => Customer
idToCustomer = {}

[...]

idToCustomer[1] = Customer(name = "Tony")

Answer 3

我更喜欢容器的复数形式。使用时有一定的可以理解的逻辑：

entries = []
for entry in entries:
     #Code...