如何为含指定静态方法的类参数添加JSDoc注解实现自动补全

你的问题出在JSDoc注解的类型标注错误：原来的@param {Parent} child是把参数标记为Parent类的实例，但你实际传入的是类本身（构造函数），所以IDE无法识别静态方法。以下是两种可行的修复方案：

方案1：直接标注构造函数类型（依赖Parent类） #

使用JSDoc的typeof关键字，获取Parent类的构造函数类型（包含所有静态成员）：

class Parent {
  static staticMethod() {
    console.log("static method")
  }
}
class Child1 extends Parent {}
class Child2 extends Parent {}

/** @param {typeof Parent} child */
function doSomething(child) {
  child.staticMethod(); // 现在会触发自动补全
}
doSomething(Child1)

这种方式最直接，因为Child1、Child2继承了Parent的静态方法，所以传入子类也能正常识别。

方案2：定义通用接口（不依赖具体类） #

如果需要更灵活的约束（比如不需要关联Parent类，只要类有指定静态方法即可），可以用JSDoc定义类型别名：

/**
 * @typedef {Object} StaticMethodHolder
 * @property {function(): void} staticMethod 约束必须存在的静态方法
 */
/** @param {typeof StaticMethodHolder} child */
function doSomething(child) {
  child.staticMethod(); // 自动补全生效
}

// 符合约束的类都可以传入
class Parent {
  static staticMethod() {
    console.log("static method")
  }
}
class Child1 extends Parent {}
doSomething(Child1)

内容的提问来源于stack exchange，提问作者Takuya HARA