装饰器通过修改类或方法行为提升代码可维护性，如用LogCreation记录类创建时间，AddTimestamp添加实例属性，MeasureTime统计方法耗时，PreventConcurrent防止异步重复执行。
JavaScript 装饰器是一种特殊类型的声明，可以被附加到类、方法、访问器、属性或参数上，用来修改或增强它们的行为。虽然目前装饰器仍处于提案阶段（Stage 3），但在 TypeScript 和一些现代框架如 Angular、NestJS 中已被广泛使用。通过实际例子，我们可以更好地理解如何在类与方法中应用装饰器。
类装饰器：控制类的创建与行为
类装饰器接收构造函数作为唯一参数，可用于监视、拦截或替换类定义。
例如，我们想记录某个类的实例化时间：
function LogCreation(target: Function) {
console.log(`${target.name} 类在 ${new Date().toISOString()} 被创建`);
}
<p>@LogCreation
class UserService {
getName() {
return "John Doe";
}
}
// 输出：UserService 类在 2025-04-05T10:00:00.000Z 被创建</p>也可以返回一个新的构造函数来扩展原始类的功能：
立即学习“Java免费学习笔记（深入）”；
function AddTimestamp<T extends { new (...args: any[]): {} }>(constructor: T) {
return class extends constructor {
createdAt = new Date();
};
}
<p>@AddTimestamp
class Post {
title: string;
constructor(title: string) {
this.title = title;
}
}</p><p>const post = new Post("Hello World");
console.log(post.createdAt); // 输出当前时间
</font>方法装饰器：监控与增强方法调用
方法装饰器应用于类的方法，接收三个参数：目标对象、成员名、成员的属性描述符。
常见用途包括日志记录、性能监控和权限检查。
jm-jsjkxyjs02-zlm-405
下载
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
比如添加一个耗时统计装饰器：
function MeasureTime(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
const originalMethod = descriptor.value;
<p>descriptor.value = function (...args: any[]) {
console.time(propertyKey);
const result = originalMethod.apply(this, args);
console.timeEnd(propertyKey);
return result;
};</p><p>return descriptor;
}</p><p>class DataProcessor {
@MeasureTime
process(data: number[]) {
return data.map(x => x * 2).filter(x => x > 10);
}
}</p><p>const processor = new DataProcessor();
processor.process([1, 5, 6, 8, 12]); // 控制台输出类似：process: 0.2ms</p>另一个实用场景是防止重复调用异步操作：
function PreventConcurrent(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
const originalMethod = descriptor.value;
let isRunning = false;
<p>descriptor.value = async function (...args: any[]) {
if (isRunning) {
console.warn(<code>${propertyKey} 正在执行中，跳过本次调用</code>);
return;
}
isRunning = true;
try {
return await originalMethod.apply(this, args);
} finally {
isRunning = false;
}
};</p><p>return descriptor;
}</p>属性装饰器与参数装饰器简要说明
属性装饰器用于监听属性的定义，常用于依赖注入系统。它接受两个参数：目标对象和属性名。
function InjectService(target: any, propertyKey: string) {
target[propertyKey] = new SomeService(); // 模拟注入
}
参数装饰器则作用于方法参数，可用于元数据标记，例如：
function Validate(target: any, methodName: string, paramIndex: number) {
Reflect.defineMetadata(`validate:${methodName}`, true, target.constructor);
}
这类功能通常结合 Reflect Metadata 实现更复杂的运行时类型系统。
基本上就这些核心实践。装饰器让代码更具声明性，把横切关注点（如日志、校验、缓存）从主逻辑中剥离。只要注意兼容性和性能影响，就能在项目中有效提升可维护性。
