JavaScript装饰器是修改类、方法等行为的语法糖，属TC39第四阶段提案，需Babel或TypeScript支持；以@开头，在类定义完成时执行，支持类、方法、访问器装饰，可实现日志、权限控制、缓存等增强逻辑。
JavaScript 装饰器（Decorator）是一种用于**修改类、方法、访问器或属性行为的语法糖**，它本身不是函数调用，而是一个在声明时被应用的“标记”，配合一个装饰器函数来实现增强逻辑。它目前处于 TC39 第四阶段提案（已进入 ECMAScript 标准草案），但需依赖 Babel 或 TypeScript 等工具支持才能在当前环境中使用。
装饰器的基本写法与触发时机
装饰器以 @ 开头，写在类、方法或属性声明之前，会在类定义完成、但实例尚未创建时执行。它本质上是“元编程”——通过操作类的描述符（descriptor）或构造函数，注入额外行为。
- 类装饰器接收目标构造函数作为唯一参数
- 方法/访问器装饰器接收三个参数：目标对象（原型或类）、属性名、属性描述符（descriptor）
- 装饰器函数可以返回新的描述符，从而改写原始行为（如添加日志、权限检查、缓存）
用装饰器扩展类：添加静态属性或封装逻辑
类装饰器适合为整个类注入通用能力，比如自动注册、打标、添加静态方法或默认配置。
function logClass(target) {
console.log('类已定义：', target.name);
target.version = '1.0.0';
target.log = () => console.log('log from decorator');
}
@logClass
class User {}
console.log(User.version); // '1.0.0'
User.log(); // 'log from decorator'
用装饰器增强方法：拦截调用、注入上下文
方法装饰器最常用，可包裹原方法，实现日志、防抖、权限控制、性能监控等。
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
立即学习“Java免费学习笔记（深入）”；
function readonly(target, key, descriptor) {
descriptor.writable = false;
return descriptor;
}
function logExecution(target, key, descriptor) {
const original = descriptor.value;
descriptor.value = function(...args) {
console.time(`[执行] ${key}`);
const result = original.apply(this, args);
console.timeEnd(`[执行] ${key}`);
return result;
};
return descriptor;
}
class Calculator {
@readonly
PI = 3.14159;
@logExecution
add(a, b) {
return a + b;
}
}
装饰器组合与实际注意事项
多个装饰器可叠加使用（从上到下执行），但要注意执行顺序和副作用。真实项目中建议：
- 优先使用 TypeScript，它对装饰器有完整类型支持和编译时检查
- 避免在装饰器中直接修改 this 或依赖运行时状态，保持纯度
- 不推荐在生产环境直接使用原生装饰器语法（除非明确支持），Babel 需开启
@babel/plugin-proposal-decorators并设legacy: true - 装饰器不能用于普通函数或变量声明，仅适用于类及其成员
基本上就这些。装饰器不是魔法，它只是让“在定义时修改行为”这件事更简洁、更可复用。用得好，能显著提升代码组织性和横切关注点的表达力。
