JS中无原生注解，但可通过JSDoc添加文档说明、Decorator实现运行时修饰。1. JSDoc用于描述类功能、作者、示例等，提升可读性；2. Decorator为实验性语法，需TypeScript支持，可修饰类行为；3. 两者可结合使用，JSDoc专注文档，Decorator增强逻辑；4. 注意兼容性与维护性，合理选择适用场景。
JavaScript 中并没有像 Java 那样的“注解”（Annotation）语法，所谓“JS 注解”通常是指在使用 TypeScript 或配合 Babel 等工具时，借鉴了其他语言的装饰器（Decorator）功能，或用于生成文档的注释标记（如 JSDoc）。因此，“JS 类注解”的实际含义多指：使用 JSDoc 对类进行说明，或使用 Decorator（实验性语法）对类及其成员进行修饰。
一、JSDoc 注释类的书写规范
JSDoc 是 JavaScript 中最常用的文档注释方式，它不改变代码逻辑，但能提升可读性，并被 IDE 和文档生成工具识别。
基本结构： 使用 /** ... */ 包裹，每行以 * 开头。
常用标签：
- @class 或 @constructor：标明这是一个类或构造函数。
- @description：描述类的功能。
- @author：作者信息。
- @version：版本号。
- @example：使用示例。
- @extends：继承的父类。
示例：
/** * 用户管理类 * @class User * @description 处理用户注册、登录等操作 * @author zhangsan * @version 1.0.0 * @extends Person * * @example * const user = new User('Alice', 25); * user.login(); */ class User extends Person { constructor(name, age) { super(name); this.age = age; }login() {
console.log(${this.name} 登录成功);
}
}
二、Decorator（装饰器）作为“类注解”的实际应用
TypeScript 支持 Decorator 语法，可用于类、方法、属性等，实现类似“注解”的功能，比如日志、权限控制、自动注册等。
启用装饰器： 在 tsconfig.json 中开启：
{ "compilerOptions": { "experimentalDecorators": true, "emitDecoratorMetadata": true } }定义类装饰器： 装饰器是一个函数，接收目标类作为参数。
function Log(target: Function) { console.log('类已创建:', target.name); }
@Log class UserService { // ... } // 输出：类已创建: UserService
装饰器工厂： 返回装饰器函数，可传参。
function Tag(name: string) { return function (target: Function) { target.prototype.tag = name; }; }@Tag('admin') class AdminUser {} // new AdminUser().tag === 'admin'
三、JSDoc 与 Decorator 的结合使用
在实际开发中，JSDoc 用于文档说明，Decorator 用于运行时行为增强，两者可共存。
/** * 管理员服务类 * @class AdminService * @description 提供管理员专属接口 */ @Tag('service') @Injectable() class AdminService { // ... }这样既保留了代码可读性，又实现了元数据注入或框架集成。
四、注意事项与最佳实践
兼容性： Decorator 是实验性语法，JavaScript 原生尚未正式支持，生产环境建议通过 TypeScript + 编译工具使用。
工具支持： VSCode、WebStorm 等 IDE 可解析 JSDoc，提供智能提示。
保持简洁： 注释应准确、简洁，避免冗余。装饰器逻辑不宜过重，保持可维护性。
基本上就这些。JS 没有原生注解，但通过 JSDoc 和 Decorator 可实现类似效果：一个面向文档，一个面向运行时行为。根据项目需求合理选择即可。
