Property setter值类型与getter返回类型不兼容，str与datetime不匹配Pylance报错

云上老周

2026-10-5

问题原因分析

这不是Pylance的误报，属于符合PEP 484类型规范的合理提示：

默认情况下，Python类型检查器约定属性的赋值类型和读取类型保持一致，也就是给start_date赋值什么类型，读取时就会返回什么类型。你的代码设计是赋值时接收str类型，内部转换为datetime类型存储，读取时返回datetime类型，属于合法但不符合默认类型约定的使用场景。
额外注意：你的代码中构造方法名存在笔误，写为了__init，缺少尾部的两个下划线，正确写法是__init__，否则类实例化时不会执行该构造逻辑。

解决方案

方案1：调整类型注解+兼容场景（推荐）

修改setter的参数类型，同时兼容str和datetime两种输入类型，既符合类型检查要求，也能提升代码鲁棒性：

from typing import Union
import datetime as dt
import logging

logger = logging.getLogger(__name__)

class YourClass:
    # 提前声明私有属性类型，辅助类型推断
    __start_date: dt.datetime

    def __init__(
        self, 
        start_date: str,
        end_date: str,
    ) -> None:
        self.start_date = start_date
        
    @property
    def start_date(self) -> dt.datetime:
        return self.__start_date
    
    @start_date.setter
    def start_date(self, val: Union[str, dt.datetime]) -> None:
        # 直接处理datetime类型输入，无需转换
        if isinstance(val, dt.datetime):
            self.__start_date = val
            return
        try:
            self.__start_date = dt.datetime.strptime(val, "%Y-%m-%d")
        except (ValueError, TypeError):
            logger.exception('Error converting start date to datetime object! Cannot continue.')
            raise