类字段/实例变量的 Pycharm 类型提示

Question

每当我们在 Java 中需要一个新对象时，我们都会声明类型和名称来选择是否给它一个初始值。在 Python 中我们不能这样做，因为我们不声明类型。

如果没有声明类型，我该如何解决这个问题；我没有收到任何代码完成提示。就像特定对象的字段或我们可以在对象上调用的任何方法......

 class Album:
    def __init__(self, name, Photo, next):
        self.name = name
        self.Photo = None
        self.next = next

    def __str__(self):
        return "Album name is: " + self.name


class Photo:
    def __init__(self, name, caption, Tag, next):
        self.name = name
        self.caption = caption
        self.Tag = Tag
        self.next = next

    def __str__(self):
        return "Photo name is: " + self.name + " with caption: " + self.caption


class Tag:
    def __init__(self, type, info, next):
        self.name = type
        self.info = info
        self.next = next

    def __str__(self):
        return "Photo name is: " + self.name


def addPhoto(toEdit, photoName, caption):

   if isinstance(toEdit, Album):    
        if toEdit.Photo is None:
            toEdit.Photo = Photo(photoName, caption, None, None)    
        else:

            tempPhoto = toEdit.Photo
            prev = None
            isFound = False 
            while tempPhoto != None:

                if tempPhoto.name.lower() == photoName.lower():
                    isFound = True
                    break

                prev = tempPhoto
                tempPhoto = tempPhoto.next

            if isFound == False:
                prev.next = Photo(photoName, caption, None, None)

            else:
                print("Photo " + photoName + " already exists in " + toEdit.name)


def deletePhoto(toEdit, photoName): 
    if isinstance(toEdit, Album):
        if photoName in toEdit.Photo.name:
            if toEdit.Photo.next is not None:
                toEdit.Photo = toEdit.Photo.next
                return True

            else:
                toEdit.Photo = None
                return True
        else:
            Photo = toEdit.Photo.next
            Photo_prev = None

            while Photo is not None:
                if Photo.name in photoName:
                    prev.next = Photo.next

                prev = Photo
                Photo = Photo.next

        print("Removed photo: " + photoName + " from " + toEdit.name)

pPtr = album1.Photo  
while (pPtr != None):
    print(pPtr)
    pPtr = pPtr.next

因此，每当我尝试执行 pPtr = album1.Photo 然后尝试访问该 pPtr 对象的任何字段时，我在 PyCharm 中都没有得到任何建议。我需要知道我做错了还是 PyCharm 有问题。

实现是一个巨大的链表。 Albums 节点包含 Photo 节点，其中包含 Tag 节点

Answer 1

首先，正如您问题的一位评论者所指出的那样，使用大写变量名会将它们与类/类型混淆。如果您查看您的问题，您会发现它甚至会混淆 Stackoverflow 代码格式化程序。

此外，在相册构造函数中，您使用本地参数屏蔽全局变量“Photo”。这可能会使 PyCharm 感到困惑，尤其是当您执行以下操作时。因此，对于下面的答案 + 测试，我将您的参数重命名为小写照片，以免干扰。

**编辑：**我确实找到了更好的方法。见“正道”。

第一次尝试

class Album:
    def __init__(self, name, photo, next):
        self.name = name
        self.photo = self.get_photo(photo)
        self.next = next

    def get_photo(self, photo):
        """
        @rtype: Photo
        """
        return photo

    def __str__(self):
        return "Album name is: " + self.name

它的工作方式是使用 PyCharm 类型推断。有关其工作原理的详细信息，请参阅here。

下面是它的工作截图：

注意：我不建议这样做，因为它是一种 hack。当我试图找出在 PyCharm 中是否有更好的方法时，我遇到了你的问题。

正确的方式

这样做的正确方法是在构造函数中给 PyCharm 变量的类型。本质上，将类型绑定从上述方法中移到构造函数中，作为文档字符串条目“type”的一部分。

class Album:
    def __init__(self, name, photo, next):
        """
        @type name: str
        @type photo: Photo
        @type next: str
        """
        self.name = name
        self.photo = photo
        self.next = next

    def __str__(self):
        return "Album name is: " + self.name


class Photo:
    def __init__(self, name, caption, Tag, next):
        self.name = name
        self.caption = caption
        self.Tag = Tag
        self.next = next

photo1 = Photo("name.txt", "caption", "tag", "next")

album1 = Album("TestAlbum", photo1, "next")

album1.photo.#code completion working here

Answer 2

这是动态类型语言的限制。类型的静态分析仅在某种程度上是可能的。所以不要期望像静态类型语言那样自动完成。

Answer 3

您应该在此处遵循 intellij 程序：

https://www.jetbrains.com/help/pycharm/type-hinting-in-product.html

例子：

class SomeClass(object):
    __logger = None  # type: Logger

 def __init__(self):
     self.__logger = logging.getLogger('root')

def some_method:
    self.__logger.info('hint completion is working here :P')