12.1.1 命名约定、模块化原则

文档摘要

12.1.1 命名约定、模块化原则命名，是代码世界的第一次呼吸。它不是语法糖，不是可有可无的注释，更不是IDE自动生成后就该被遗忘的占位符——它是编译器尚未介入时，人类与代码之间最原始、最直接、最不可妥协的契约。当你写下，你不仅在调用一个函数；你在向三个月后的自己、向刚加入项目的同事、向静态分析器、向类型推导引擎、甚至向未来可能接入的AI辅助编程系统，发出一份结构化声明：这个标识符代表“一个同步获取单个用户实体的操作，其主键依据为整型或字符串ID，返回值为用户对象或null/undefined”。命名即契约，契约即接口，接口即设计。而模块化，则是这场契约得以规模化存续的物理载体。它不是简单地把文件按功能切开，也不是靠目录层级堆砌出的虚假秩序。