如何将Python多分支函数的认知复杂度从19降至SonarLint允许的15

方法1：用字典映射完全替代elif链 #

这是最简洁高效的方式，把字符和对应数值的映射关系放进字典里，直接通过键查找返回值，不管有多少映射项，认知复杂度都会降到极低的水平。

示例代码：

def char_to_value(c):
    char_map = {
        'a': 0,
        'b': 1,
        'c': 2,
        'd': 3,
        # 这里可以继续添加所有需要的字符映射
    }
    # 处理未匹配到的情况，返回默认值或者抛出异常都可以
    return char_map.get(c, -1)

方法2：分组拆分elif链 #

如果不想完全用字典，可以把多个elif分支按逻辑（比如字符类别、数值区间）分成几组，每组内部用字典或者少量判断，主函数只保留少数几个elif分支，把单函数的分支数控制在14以内。

示例代码：

def char_to_value(c):
    # 第一组：常见字母映射
    if c in {'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n'}:
        group1_map = {
            'a':0, 'b':1, 'c':2, 'd':3, 'e':4,
            'f':5, 'g':6, 'h':7, 'i':8, 'j':9,
            'k':10, 'l':11, 'm':12, 'n':13
        }
        return group1_map[c]
    # 第二组：其他字母映射
    elif c in {'o', 'p', 'q', 'r', 's', 't'}:
        group2_map = {'o':14, 'p':15, 'q':16, 'r':17, 's':18, 't':19}
        return group2_map[c]
    # 更多分组...
    else:
        return -1

这种方式下，主函数的elif分支数只有2个左右，完全符合SonarLint的要求，每组内部的字典查找不会增加认知复杂度。

方法3：拆分函数，分散分支压力 #

把原来的长elif链拆分成多个子函数，每个子函数的分支数控制在14以内，主函数只负责调用这些子函数，这样每个函数的认知复杂度都能达标。

示例代码：

def _map_first_14_chars(c):
    if c == 'a':
        return 0
    elif c == 'b':
        return 1
    elif c == 'c':
        return 2
    # 继续添加到14个分支为止
    elif c == 'n':
        return 13
    return None

def _map_remaining_chars(c):
    if c == 'o':
        return 14
    elif c == 'p':
        return 15
    # 剩下的分支放在这里
    return None

def char_to_value(c):
    result = _map_first_14_chars(c)
    if result is not None:
        return result
    result = _map_remaining_chars(c)
    if result is not None:
        return result
    return -1

每个子函数的分支数不超过14，主函数只有2个判断分支，整体认知复杂度自然降到允许范围内。

内容的提问来源于stack exchange，提问作者Manuel González Costa