TypeScript中如何标记供反射库的公共构造函数为禁止直接调用？

针对这种必须设为public但不希望外部直接调用的构造函数，有几种能被主流IDE识别的实用方案：

1. 用@Deprecated注解加明确说明 #

这是最直接且IDE原生支持的方式，IntelliJ、Eclipse等都会对标记的构造函数显示警告或删除线，配合注解说明明确禁用原因：

@Deprecated(since = "1.0", forRemoval = false)
public MyClass() {
    // 构造逻辑
}

同时在Javadoc里补充强提示：

/**
 * 请勿直接调用此构造函数！
 * 仅用于反射库调用或内部静态工厂方法，直接调用可能导致对象状态异常。
 * @deprecated 仅允许反射/内部工厂使用，外部请通过XXX工厂方法创建实例
 */

2. 使用内部标记参数限制调用 #

增加一个仅包内可见的标记参数，让外部调用者无法合法传入参数，只有内部工厂和反射能绕过这个限制：

public class MyClass {
    // 包私有标记类，外部无法实例化
    static final class InternalOnlyMarker {}

    /**
     * 请勿直接调用此构造函数！
     * 仅用于反射或内部工厂方法
     */
    public MyClass(InternalOnlyMarker marker) {
        if (marker == null) {
            throw new IllegalArgumentException("非法调用：仅允许内部或反射使用");
        }
        // 构造逻辑
    }

    // 内部静态工厂方法
    static MyClass createInstance() {
        return new MyClass(new InternalOnlyMarker());
    }
}

外部代码尝试new MyClass()会因参数不匹配报错，而反射可通过指定参数类型正常调用，完全不影响原有逻辑。

3. 自定义/使用框架的内部注解 #

很多框架提供了标记内部API的注解，比如Guava的@Internal，也可以自定义专属注解：

@Retention(RetentionPolicy.SOURCE)
@Target(ElementType.CONSTRUCTOR)
public @interface ForReflectionOrInternalFactoryOnly {}

之后在IDE中配置这个注解的提示规则（比如IntelliJ可在Settings -> Inspections里设为警告），开发者调用时IDE会直接给出提示。

4. Javadoc强警告 #

即使不用注解，也可以在Javadoc里用醒目的格式提醒：

/**
 * <strong>警告：禁止直接调用！</strong>
 * 此构造函数仅为反射库和内部静态工厂方法设计，外部调用将导致不可预期的行为。
 * 请使用{@link #createInstance()}方法创建实例。
 */
public MyClass() {
    // 构造逻辑
}

主流IDE在悬停查看构造函数文档时会直接显示这个警告。

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