如何让PyCharm结构窗口显示代码分组以优化函数导航？

方法一：用类作为逻辑分组容器 #

• 把同组函数放到无实例化需求的类中，类名直接作为分组名称，将函数定义为静态方法或类方法
• 结构窗口会自动显示类层级，展开就能看到组内所有函数，天然形成清晰分组
• 示例代码：

class DataProcessing:
    @staticmethod
    def clean_raw_data():
        pass

    @staticmethod
    def transform_data_format():
        pass

class ModelTraining:
    @staticmethod
    def init_model():
        pass

    @staticmethod
    def train_model():
        pass

• 优势：原生支持无需额外配置，结构窗口层级一目了然
• 注意：如果不需要类的实例化逻辑，用@staticmethod避免不必要的实例关联

方法二：文档字符串加自定义标记配合结构窗口过滤 #

• 在函数文档字符串开头添加统一分组标记，比如[数据处理]、[模型训练]
• 示例代码：

def clean_raw_data():
    """[数据处理] 清洗原始输入数据"""
    pass

def transform_data_format():
    """[数据处理] 转换数据格式适配模型"""
    pass

def init_model():
    """[模型训练] 初始化模型结构"""
    pass

• 在PyCharm结构窗口（快捷键Alt+7）右上角的搜索框输入标记内容，就能快速筛选出同组函数
• 进阶操作：可以在Settings → Editor → File and Code Templates中给函数模板添加分组标记占位符，方便统一管理

方法三：利用书签功能临时分组 #

• 选中同组函数，右键点击行号旁空白区域选择「Add Bookmark」，给同组书签设置统一颜色或标签
• 通过View → Tool Windows → Bookmarks打开书签窗口，按颜色/标签筛选查看同组函数
• 适合临时分组或小范围的函数归类

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