Clarify the diffrence between object.__sizeof__() and sys.getsizeof() in short documentation/help output

Documentation

Problem

The short documentation shown by help()/pydoc makes object.__sizeof__() and sys.getsizeof() look almost equivalent, even though they may return different values in practice.

For example, their short descriptions currently read very similarly:

• sys.getsizeof():

  Return the size of object in bytes.

• object.__sizeof__():

  "Size of object in memory, in bytes."

From these short descriptions, a user can reasonably assume that both functions report the same value.

Why this is confusing

In practice, they can differ.

sys.getsizeof() may return a larger value than obj.__sizeof__(), because it is not just a direct alias for __sizeof__(). The full documentation for sys.getsizeof() explains the extra behavior, but that distinction is not obvious from the short help output.

This makes the following kind of session surprising:

import sys

class A:
    pass

obj = A()

print(obj.__sizeof__())
print(sys.getsizeof(obj))

A user who relies on help() or short docstrings may expect the first two values to match, but they may not.

Suggestion

It may be helpful to clarify this distinction in the short documentation, so that it is visible without referring to the full documentation.

In particular, it could clarify that:

• sys.getsizeof() may include additional overhead beyond the value returned by __sizeof__()

Linked PRs

• gh-146087

先比較 sys.getsizeof() 和 object.sizeof() 的簡短說明或 pydoc 輸出，接著檢視連結的 PR gh-146087，了解已在進行的工作。當簡短描述清楚區分 sys.getsizeof() 和 sizeof()，並說明可能包含額外開銷時，即表示完成。