在代码中使用目录?

您是否使用目录在大源代码文件的开头列出类的所有函数(可能还有变量)?我知道,除了这类列表之外,另一种选择是将大文件拆分成更小的类/文件,这样它们的类声明就足够不言而喻了。。但是一些复杂的任务需要大量的代码。我不确定花时间将实现细分为多个文件是否真的值得?或者可以在类/接口声明之外创建索引列表吗?

编辑:

为了更好地说明我如何使用目录,这是我的爱好项目中的一个例子。实际上不是列出函数,而是函数内部的代码块。。但你还是可以得到这个主意。。

/*
CONTENTS

Order_mouse_from_to_points
Lines_intersecting_with_upper_point
Lines_intersecting_with_both_points
Lines_not_intersecting
Lines_intersecting_bottom_points
Update_intersection_range_indices
    Rough_method
    Normal_method
        First_selected_item
        Last_selected_item
        Other_selected_item

*/


void SelectionManager::FindSelection()
{

    // Order_mouse_from_to_points
    ...
    // Lines_intersecting_with_upper_point
    ...

    // Lines_intersecting_with_both_points
    ...

    // Lines_not_intersecting
    ...

    // Lines_intersecting_bottom_points
    ...

    // Update_intersection_range_indices
    for(...)
    {
        // Rough_method
        ....

        // Normal_method
        if(...)
        {
            // First_selected_item
            ...

            // Last_selected_item
            ...

            // Other_selected_item
            ...
        }


    }

}

请注意,索引项没有空格。因此,我可以单击其中一个并按F4键跳转到项目用法,按F2键跳回(简单的visual studio find next/prevous快捷方式)。

编辑:

这个索引的另一个替代解决方案是使用折叠的C区。您可以将visual studio配置为只显示区域名并隐藏所有代码。当然,对源代码导航的键盘支持是相当麻烦的。。。