使用 @extends 标注类继承关系，如 @extends {Animal}，可提升JavaScript代码的可读性和IDE支持，结合 @class 和 @abstract 能更清晰表达类结构，尤其在启用 // @ts-check 时增强类型检查。
在JavaScript中，虽然没有像Java那样的正式注解（Annotation）语法，但在使用JSDoc这样的文档工具时，可以通过特定的标签来标注类之间的继承关系，帮助开发者理解代码结构、提升IDE智能提示的准确性。特别是在使用ES6+的class语法时，正确书写JSDoc注解对维护大型项目非常有帮助。
使用 @extends 或 @extends 标注继承关系
在JSDoc中，标注一个类继承自另一个类，应使用 @extends（或等价的 @augments）标签。
语法格式如下：
/** * @extends {父类名称} */示例：
/** * 动物基类 */ class Animal { constructor(name) { this.name = name; }speak() {
console.log(${this.name} 发出声音。);
}
}
/**
- 狗类，继承自动物
- @extends {Animal}
*/
class Dog extends Animal {
constructor(name, breed) {
super(name);
this.breed = breed;
}
bark() {
console.log(${this.name} 汪汪叫！);
}
}
通过 @extends {Animal}，IDE（如VS Code、WebStorm）就能识别 Dog 类拥有 Animal 的所有方法和属性，并提供自动补全和类型检查支持。
结合 @class 和 @abstract 使用更清晰
为了增强文档可读性，可以配合其他JSDoc标签：
- @class：显式声明这是一个类。
- @abstract：表示该类是抽象类，不应被直接实例化。
示例：
/** * 抽象形状类 * @class * @abstract */ class Shape { getArea() { throw new Error('子类必须实现 getArea 方法'); } }/**
- 矩形类
- @extends {Shape}
- @class
*/
class Rectangle extends Shape {
constructor(width, height) {
super();
this.width = width;
this.height = height;
}
getArea() {
return this.width * this.height;
}
}
在 TypeScript 中的差异
如果你使用的是TypeScript，则不需要依赖JSDoc来表达继承关系，因为继承在类型系统中是显式的。但若你在纯JS文件中使用TypeScript的类型检查（如通过 // @ts-check），正确的JSDoc注解就尤为重要。
例如，在启用 // @ts-check 的JS文件中：
// @ts-check/* @extends {Animal} / class Cat extends Animal { constructor(name) { super(name); }
// IDE会提示 speak() 已从 Animal 继承 meow() { this.speak(); // 正确调用父类方法 } }
此时，TypeScript会基于JSDoc进行类型推断，确保调用合法。
常见注意事项
- 大括号不能省略：@extends Animal 写法不规范，应写作 @extends {Animal}，否则可能无法被解析。
- 确保父类已定义或导入：如果父类在另一个模块中，建议使用 import() 语法说明类型来源，如 @extends {import('./Animal').Animal}。
- IDE支持程度不同：VS Code对JSDoc支持良好，但某些旧编辑器可能忽略这些注解。
基本上就这些。正确使用 @extends 注解，能显著提升JavaScript项目的可维护性和开发体验，尤其是在没有强类型语言环境的情况下。
