在getter上写文档字符串，因为1）就是
help(MyClass)显示的内容，2）也是在Python文档中的完成方式-请参阅x.setter示例。
关于1）：
class C(object): @property def x(self): """Get x""" return getattr(self, '_x', 42) @x.setter def x(self, value): """Set x""" self._x = value
接着：
>>> c = C()>>> help(c)Help on C in module __main__ object:class C(__builtin__.object) | Data descriptors defined here: | | __dict__ | dictionary for instance variables (if defined) | | __weakref__ | list of weak references to the object (if defined) | | x | Get x>>>
请注意，设置者的文档字符串“ Set x”将被忽略。
因此，您应该在getter函数上为整个属性（getter和setter）编写docstring，以使其可见。一个好的属性文档字符串的示例可能是：
class Serial(object): @property def baudrate(self): """Get or set the current baudrate. Setting the baudrate to a new value will reconfigure the serial port automatically. """ return self._baudrate @baudrate.setter def baudrate(self, value): if self._baudrate != value: self._baudrate = value self._reconfigure_port()
