13、代码可读性问题剖析

代码可读性问题剖析

1. 过度抽象

良好的意图有时也可能导致不良的结果。封装原子类型并使用包装器确实能让源代码更易于适应变化，但任何策略走向极端都是有害的。过度封装会让你迷失在层层包装之中，甚至需要深入 50 层的层级结构才能看清实际被修改的内容。

以下是一个过度抽象的示例代码：

struct TextValue
{
    char *string;
};
struct TextField
{
    struct TextValue textValue;
};
struct SimpleKeyField
{
    struct TextField textField;
};
struct RelationalKeyField
{
    struct SimpleKeyField simpleKeyField;
};
struct KeyField
{
    struct RelationalKeyField relationalKeyField;
};

实际上，我们处理的只是一个字符串，但它被反复包装，让人难以察觉。在实际应用中，这种嵌套可能会分散在多个文件中，使得调试时遍历这些不同层次变得非常繁琐，除非你确切知道自己在寻找什么。

2. 代码混淆

2.1 国际混淆 C 代码竞赛示例

混淆代码就是故意让代码难以阅读。国际混淆 C 代码竞赛（IOCCC）网站展示了许多大师级的混淆代码作品。例如，1984 年有匿名程序员提交的以下代码：

#inclu