如何在PyCharm中获取实现Python Protocol的类列表？

一、PyCharm内置功能优化 #

• 确保你的PyCharm版本在2021.3及以上，这个版本后官方加强了对Protocol的类型推断支持
• 打开Settings/Preferences → Editor → General → Code Completion，勾选Show implementations for protocols选项
• 完成设置后，按住Cmd+Click（Mac）或Ctrl+Click（Windows/Linux）点击Protocol类名，就能直接跳转查看所有实现类；也可以右键Protocol类，选择Find Usages → Implementations来批量查看

二、静态类型分析工具 #

• mypy：在项目根目录执行mypy --strict your_project/，它会识别所有符合目标Protocol结构的类。如果需要批量提取，可以借助mypy的API编写简单脚本解析检查结果：

from mypy.api import run

# 运行mypy检查并生成报告
stdout, stderr, exit_code = run(["--strict", "--json-report", "./mypy_report", "your_project/"])
# 解析./mypy_report目录下的json文件，提取符合目标Protocol的类信息

• pyright：执行pyright your_project/后，查看终端输出或生成的JSON报告，它同样能精准识别Protocol的实现类，还支持通过pyrightconfig.json配置检查范围和规则

三、项目内手动标记（小规模项目适用） #

如果项目体量不大，可以给实现Protocol的类加上统一的注释标记，方便快速检索：

from typing import Protocol

class DataProcessor(Protocol):
    def process(self, data: dict) -> dict: ...

# 标记为实现DataProcessor Protocol
class JSONProcessor:
    """Implements DataProcessor"""
    def process(self, data: dict) -> dict:
        return {k: str(v) for k, v in data.items()}

之后通过编辑器的全局搜索功能，搜索Implements DataProcessor就能快速定位所有实现类

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