JavaScript虽无原生注解，但通过Babel或TypeScript可使用实验性装饰器语法实现类、方法、属性、参数及访问器的装饰，广泛应用于Angular、NestJS等框架中。
JS本身并不原生支持“注解”（Annotation）语法，像Java或TypeScript中的装饰器（Decorator）那样。但通过Babel等转译工具，开发者可以在JavaScript中使用实验性的装饰器语法，这种语法常被称作“JS注解”。这些装饰器可用于类、方法、属性等，配合类型系统（如TypeScript）可实现更强大的元编程能力。
1. 装饰器（常被称为JS注解）支持的类型
在使用Babel或TypeScript开启装饰器功能后，JS支持以下几类装饰器，也就是通常所说的“注解”：
- 类装饰器：作用于整个类，可用于修改类的行为或元数据。
- 方法装饰器：应用于类的方法，可用于拦截调用、日志记录、权限控制等。
- 属性装饰器：用于类的属性声明，常用于依赖注入或字段验证。
- 参数装饰器：作用于方法参数，可用于标记参数用途或进行类型注入。
- 访问器装饰器：应用于getter/setter，行为类似方法装饰器。
2. TypeScript中的注解与类型定义
TypeScript对装饰器提供了更完整的类型支持，开发者可以为装饰器定义明确的函数签名：
- 类装饰器类型：type ClassDecorator = (target: Function) => void | Function;
- 属性装饰器类型：type PropertyDecorator = (target: Object, propertyKey: string | symbol) => void;
- 方法装饰器类型：type MethodDecorator = (target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
- 参数装饰器类型：type ParameterDecorator = (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
3. 常见使用场景与框架支持
许多现代前端框架利用“JS注解”实现声明式编程：
网奇企业网站管理系统CWMS2.0 英文版
下载
CWMS 2.0功能介绍：一、 员工考勤系统，国内首创CWMS2.0的企业员工在线考勤系统。二、 自定义URL Rewrite重写，友好的搜索引擎 URL优化。三、 代码与模板分离技术，支持超过5种类型的模板类型。包括：文章、图文、产品、单页、留言板。四、 购物车功能，CWMS2.0集成国内主流支付接口。如：淘宝、易趣、快钱等。完全可媲美专业网上商城系统。五、 多语言自动切换 中英文的说明。六、
- Angular：使用@Component、@Input等装饰器定义组件和输入属性。
- NestJS：大量使用装饰器如@Controller、@Get来构建服务端路由和依赖注入。
- MobX：通过@observable、@action管理状态。
4. 注意事项与限制
尽管“JS注解”功能强大，但仍需注意以下几点：
- 装饰器目前仍处于ECMAScript提案阶段（Stage 3），未正式纳入标准。
- 需要Babel插件（如@babel/plugin-proposal-decorators）或TypeScript配置（experimentalDecorators: true）才能启用。
- 装饰器不能用于函数、变量等非类成员的声明。
- 生产环境使用时应评估兼容性与打包体积影响。
基本上就这些。虽然JavaScript没有原生注解机制，但通过装饰器语法模拟的“注解”已在工程实践中广泛使用，尤其在TypeScript生态中非常成熟。理解其支持的类型和使用方式，有助于更好地掌握现代前端架构设计。不复杂但容易忽略的是编译配置和语法版本的匹配问题。
