Python类内部用自身类名做回调类型提示触发Pylance警告

这是Python静态类型检查里的前向引用问题——你在类内部的类型标注里直接用了TCPClient，但此时类本身还没完成定义，Pylance作为静态分析工具，在解析到这个标注时找不到已经定义好的TCPClient类，所以抛出未定义的警告。而你导入自身的操作，相当于给工具提供了一个提前的“符号提示”，但这其实是绕远路的办法，还可能引发循环导入风险。

给你几个更合理的解决方式：

• 用字符串形式标注类型：把Callable[[str, TCPClient]]改成Callable[[str, "TCPClient"]]，用字符串包裹类名，Pylance会识别这是对当前类的引用，无需额外导入。
• 启用延迟类型解析：在文件最顶部加上from __future__ import annotations（Python 3.7+支持，3.10+默认优化了这个特性），这句代码会让所有类型标注都以字符串形式暂存，直到运行时才去解析，这样直接写TCPClient也不会有警告。
• 避免内部自导入：你之前用的内部导入自身的方法虽然能消警告，但属于非常规操作，容易在后续代码扩展时触发循环导入问题，不建议长期使用。

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