ES6静态块用于类定义完成后立即执行一次性初始化逻辑，适合处理静态可确定的高级元数据，如装饰器注册的字段规则、枚举映射表、预计算常量及全局注册表条目。
ES6 的静态块（static{}）不是用来“加载类”的，而是类定义完成、准备就绪后立即执行的一次性初始化逻辑。它天然适合在类加载阶段集中处理高级元数据——比如注解映射、字段规则注册、校验器绑定等——但关键在于：这些元数据必须是**静态可确定的、不依赖实例状态的**。
静态块能初始化哪些高级元数据
静态块中可安全操作的是类自身声明的静态成员、外部已存在的工具函数，以及可通过同步方式获取的元数据源。典型可用元数据包括：
- 基于装饰器（如
@Field({ type: 'string', required: true })）提前扫描并注册的字段约束规则（需配合 Babel/TypeScript 装饰器插件，在编译期生成元数据） - 枚举键与业务语义的映射表（如
StatusMap），用于后续运行时快速查表 - 静态方法或构造器所需的预计算常量（如正则表达式字面量、默认配置对象深拷贝结果）
- 全局注册表条目（如将当前类的
schema注册到SchemaRegistry中，供其他模块发现）
如何在继承链中正确使用静态块初始化元数据
子类的静态块总是在父类静态块执行完毕后才运行。这个顺序可用于分层构建元数据：父类定义通用结构，子类叠加特化信息。
例如：
static schema = {};
static {
this.schema.id = { type: 'number', autoIncrement: true };
}
}
class User extends BaseEntity {
static {
// 自动继承父类 schema
this.schema = { ...BaseEntity.schema };
// 叠加子类专属字段
this.schema.name = { type: 'string', minLength: 2 };
this.schema.email = { type: 'string', format: 'email' };
}
}
这样，User.schema 就自然包含了 id 和子类扩展字段，无需手动合并。
避免常见陷阱：元数据不可变性与异常阻断
静态块执行失败会直接导致类初始化中断，后续任何对该类的引用都会抛出 NoClassDefFoundError。这对元数据初始化反而是优势——它强制你在早期暴露问题。
- 用
Object.freeze()或Object.seal()锁定最终元数据对象，防止运行时被意外修改 - 对关键字段做存在性校验：
if (!this.schema.name) throw new Error('Missing required field: name') - 避免在静态块中调用异步 API（如
fetch）、读取未就绪的全局配置对象，或访问尚未定义的父类静态属性（除非明确知道其初始化顺序）
与装饰器协同：让元数据真正“可读”
纯 JavaScript 没有原生运行时注解，但借助 TypeScript 装饰器 + reflect-metadata，你可以在静态块中统一提取和归档字段元数据：
function Field(options) {
return function(target, propertyKey) {
const metadataKey = `field:${propertyKey}`;
Reflect.defineMetadata(metadataKey, options, target.constructor);
};
}
class FormModel {
@Field({ required: true })
username;
@Field({ type: 'email' })
email;
static validationRules = {};
static {
const keys = Object.getOwnPropertyNames(this.prototype);
keys.forEach(key => {
const meta = Reflect.getMetadata(`field:${key}`, this);
if (meta) this.validationRules[key] = meta;
});
}
}
此时 FormModel.validationRules 已在类加载时准备好，后续校验逻辑可直接使用，无需每次反射查询。
