TypeScript装饰器通过声明式函数增强类与成员行为，支持编译期类型检查与运行时元编程，广泛用于日志、依赖注入及框架设计，提升代码可维护性与复用性。
TypeScript 中的装饰器显著增强了 JavaScript 的元编程能力，通过提供一种声明式、可复用的方式来修改类及其成员的行为。虽然 JavaScript 原生尚未正式支持装饰器（目前处于提案阶段），但 TypeScript 很早就实现了对装饰器的实验性支持，使得开发者能在编译阶段实现更强大的类型检查和代码生成。
装饰器扩展了类和成员的动态修改能力
装饰器本质上是特殊类型的函数，可以应用于类、方法、属性、参数等。它们在代码运行前被求值，允许你在不修改目标源码的前提下注入或包装逻辑。
例如，你可以使用类装饰器自动注册服务、添加元数据或启用日志功能：
function LogClass(target: Function) {console.log('类已创建:', target.name);
}
@LogClass
class UserService { }
// 输出：类已创建: UserService
这种机制让程序具备更强的自省和配置能力，属于典型的元编程场景。
立即学习“Java免费学习笔记（深入）”；
方法和属性装饰器支持拦截与增强
方法装饰器可用于监控调用、缓存结果或实现权限控制。通过替换或包装原方法，你可以在运行时改变其行为。
常见用例包括：
- 使用 @readonly 防止方法被重写
- 使用 @debounce 控制高频调用
- 使用 @log 记录方法执行信息
descriptor.writable = false;
}
这些操作直接操纵对象的描述符，体现了 JavaScript 原型系统的灵活性，并通过 TypeScript 提供静态类型保障。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
元数据反射促进依赖注入和框架设计
TypeScript 装饰器常配合 reflect-metadata 使用，为类附加额外信息。这在构建依赖注入容器、ORM 或路由系统时非常关键。
比如，你可以定义一个 @Injectable() 装饰器标记可注入类，框架在运行时读取这些元数据并自动解析依赖关系。
这种模式广泛用于 Angular 等框架中，极大提升了代码组织性和可测试性。
编译期转换带来类型安全的元编程
TypeScript 的最大优势在于将装饰器的副作用纳入类型系统。尽管装饰器本身操作的是运行时结构，但 TS 能在编译阶段验证装饰目标的类型是否匹配，减少错误。
例如，你不应把方法装饰器用于属性上，TypeScript 可以通过类型签名提前报错。
此外，TS 编译器会将装饰器转换为 ES5/ES6 兼容代码，使高级抽象能在旧环境中运行。
基本上就这些——TypeScript 装饰器让元编程变得更安全、更直观，同时推动了现代前端框架的设计演进。虽然未来 JavaScript 标准化装饰器后语法可能变化，但其核心思想已在实践中证明价值。
