PyCharm警告：MyClass类未解析属性引用问题求助

你遇到的Unresolved attribute reference "number_of_clicks" for class "MyClass"警告，核心原因是：你在__init__方法里仅对类属性做了类型注解，但没有实际初始化这些属性——PyCharm无法确认实例化后这些属性一定存在，因此抛出该警告。

问题代码回顾 #

from prometheus_client import Counter, Gauge, Histogram
import time
from typing import Optional  # 原代码遗漏该导入

class MyClass:
    def __init__(self):
        self.number_of_clicks: Optional[Counter]
        self.number_of_items: Optional[Gauge]
        self.prometheus_processing_time: Optional[Histogram]

    def do_something():  # 缺失self参数和方法定义括号
        number_of_clicks = ...
        number_of_items = ...
        elapsed_time = time.time_ns() - start_time  # start_time未定义
        self.number_of_clicks.inc(amount=number_of_clicks)
        self.number_of_items.inc(amount=number_of_items)
        self.prometheus_processing_time.inc(amount=elapsed_time)

解决方案：实际初始化Prometheus指标 #

你猜测的方向是正确的——必须在__init__中为这些属性赋值具体的Prometheus指标实例，而非仅做类型注解。同时需要修正代码里的语法和使用错误：

1. 若指标不会为None，可去掉Optional注解，让类型检查更严谨；
2. Prometheus指标初始化需指定名称、帮助信息等必要参数；
3. 修正方法定义、变量未定义的语法问题，以及Prometheus指标的调用方法错误（比如Histogram用observe而非inc）。

修正后的代码示例：

from prometheus_client import Counter, Gauge, Histogram
import time

class MyClass:
    def __init__(self):
        # 直接初始化Prometheus指标，无需Optional（除非有置空场景）
        self.number_of_clicks = Counter(
            "myclass_click_count", 
            "Total number of clicks handled by MyClass"
        )
        self.number_of_items = Gauge(
            "myclass_item_count", 
            "Current number of items processed by MyClass"
        )
        self.prometheus_processing_time = Histogram(
            "myclass_processing_time_ns", 
            "Processing time of do_something in nanoseconds"
        )

    def do_something(self):
        start_time = time.time_ns()
        # 模拟业务逻辑
        number_of_clicks = 1
        number_of_items = 5
        
        elapsed_time = time.time_ns() - start_time
        self.number_of_clicks.inc(amount=number_of_clicks)
        self.number_of_items.set(number_of_items)  # Gauge常用set设置当前值
        self.prometheus_processing_time.observe(elapsed_time)  # Histogram用observe记录数值

额外说明 #

• Gauge类型一般用set()设置当前值，inc()仅适用于累加场景；
• Histogram类型必须用observe()记录观测值，原代码中的inc()调用是错误的；
• 若确实需要让指标为None（比如根据条件初始化），可保留Optional注解，但使用前必须做非空判断，避免运行时报错。

内容的提问来源于stack exchange，提问作者Tobitor