Pydev 代码完成一切

Question

在许多情况下（例如函数参数）Pydev 并不静态地知道变量的类型。因此，代码完成（在 . 之后或使用 ctrl+space 时）不起作用。

在大多数情况下，您在设计软件时知道运行时的类型。有没有办法提示 Pydev 正确编码完成它？

我想这可能需要特定的 Pydev 功能，甚至可能需要新的 Python PIP。

这实际上似乎是所有动态语言的普遍问题......

更新：
也许有一个例子可以澄清：

def some_func(a_list, an_object):
    a_list.app        # Here I would not get code completion for append

如果 Pydev（或 PIP）支持的话，可以工作的例子：

from someobj import SomeObject
def some_func(a_list, an_object):
    # typecast: a_list=list
    # typecast: an_object=SomeObject
    a_list.app        # Now code completion would show append

我不认可这个特定的方法 - 它只是一个例子可以工作的系统。同样，当然这不应该是强制性的 - 但有时缺乏暗示类型的可能性是令人烦恼的。

Answer 1

[编辑]

从 PyDev 2.8.0 开始，它可以使用文档字符串和注释来发现对象的类型。

有关支持格式的详细信息，请参阅：http://pydev.org/manual_adv_type_hints.html。

[PyDev 2.8.0 之前]

以前，它仅支持断言 isinstance 调用（这仍然有效）：

assert isinstance(a_list, list)

PyDev 将能够识别它并正确地为其提供代码完成（请注意，您可以运行稍后如果您发现没有断言的 Python 会使代码变慢： 什么Python 优化（-O 或 PYTHONOPTIMIZE）有作用吗？）

Answer 2

从 PyDev 2.8.0 开始，可以使用 Sphinx 或 Epydoc 注释来完成代码：
http://pydev.org/manual_adv_type_hints.html

Answer 3

如果您使用 PyCharm，您可以选择 epydoc 或 sphinx 文档字符串样式并指定参数类型和函数返回根据该样式的值（进一步讨论）

Answer 4

我通常会做什么来规避这个问题。

def func(my_list_param):
    my_list_param = []
    my_list_param.appe # at this stage I would get code completion.

只需记住在测试或提交时删除变量初始化即可。
哦，顺便说一句，标记为答案的回复似乎对我不起作用。

Answer 5

如果您在代码中使用 Python >= 3.5，则可以在函数声明中指定参数类型 (26.1. 类型 - 支持类型提示），因此您的代码可以是：

from someobj import SomeObject

def some_func(a_list: list, an_object: SomeObject):
    a_list.app           # Code completion works
    an_object.a_method() # Code completion works

这种类型的语法对执行没有影响，并且不会对传递给函数的实际类型进行任何检查，但使您的代码更具可读性并使代码完成工作有效。