当您开始编写函数时,Pycharm 5.0会自动完成docstring: 然而,这种格式似乎并不遵循任何良好的最佳实践。有什么方法可以更改它,使参数符合Sphinx autodoc格式?def communicate(self, bytes): """Communicate with devices :param bytes: Outgoing request as array of bytes """
你可以通过转到 文件 -> 设置 -> 工具 -> Python集成工具 来更改默认的文档字符串格式,并在“文档字符串格式”下拉框中选择你喜欢的样式。 Sphinx使用reStructuredText。
Plain
、Epytext
、reStructuredText
、Numpy
和Google
。 - luckydonald