Pycharm不会自动创建文档存根

时间:2016-03-29 19:05:38

标签: python pycharm

我不确定为什么会在这台电脑上发生这种情况;它从来没有发生过任何其他事情。当我尝试在pycharm中为函数或类创建docstring时,没有任何反应。即:

def foo(bar):
    """"""
    pass

按Enter键应插入文档字符串;相反,它只是做:

def foo(bar):
    """
    """
    pass

5 个答案:

答案 0 :(得分:6)

我在pyCharm 2019.3.1中遇到了同样的问题,我只是按照pyCharm site's documentation

上的说明进行了解决

具体在“ 文档字符串格式”部分中,然后按以下步骤操作:

Docstring format

以防万一对2020年的所有人有帮助:)

答案 1 :(得分:5)

确保在 File -> Settings -> Tools -> Python Integrated Tools 中选择了文档字符串格式

答案 2 :(得分:3)

这是known bug,应在2016.1.1中修复。

一个解决方法,如问题中所述:

  

对此的解决方法是在第一行的代码之前只是“”“   填充时将该代码放入换行符。笨重,但它是一种解决方法   现在。

答案 3 :(得分:1)

为了解决这个问题,我不得不进入 Settings -> Tools -> Python Integrated Tools 并重置文档字符串格式。我这样做是通过将 Docstring formatEpytext 更改为 Plain,单击 Apply,然后再次将其改回 Epytext 并应用更改,现在一切正常.

PyCharm 版本:2021.1.2(社区版)

答案 4 :(得分:0)

我设法通过将MacOSX上的键盘首选项从美国国际 - PC改为英国来解决这个问题。美国国际组织中的双引号 - PC触发系统等待字母重音,例如“然后e变成ë。但是,它似乎在所有编辑器中表现不一样。”

仅仅是猜测,但也许在PyCharm的背景中有一些格式化魔法由于在使用US International时添加了一些额外的(也是看不见的)格式而无法正常工作 - PC会阻止PyCharm添加它需要的上下文知道它应该在按Enter后创建文档字符串吗?