TypeScript嵌套类报错：遵循官方手册仍遇环境上下文访问器错误

咱们先拆解一下这个问题——你按照官方手册的「命名空间与类合并」写法实现嵌套类，结果在添加Hourly()、Daily()这类方法时触发了错误，核心原因是你不小心把代码放在了「环境上下文（ambient context）」里，而这个上下文只允许做类型声明，不能写具体的实现逻辑。

先看错误代码的典型场景 #

你可能写出了类似这样的代码（大概率是不小心用了declare或者在.d.ts文件里写实现）：

// 错误示例：用了declare修饰类，进入环境上下文
declare class Schedule {
  repeat: Schedule.Repeat;
}

namespace Schedule {
  export class Repeat {
    // 这里的Hourly方法写了具体实现，在环境上下文里会报错
    Hourly() {
      return new Repeat();
    }

    // 如果用了访问器，错误会更直接命中提示
    get Daily() {
      return new Repeat();
    }
  }
}

为什么会报错？ #

「环境上下文」指的是TypeScript中用来描述已有代码类型的场景，包括：

• .d.ts 类型声明文件的顶层代码
• 被declare关键字修饰的类、命名空间、接口等块级内容

在这个上下文里，你只能定义类型结构（比如方法的参数和返回值），不能写具体的函数体、访问器逻辑——因为这些属于代码实现，不属于类型声明。

正确的实现方式 #

1. 在普通.ts文件中写实现（最常见的场景） #

如果你的代码是业务实现，直接放在.ts文件里，去掉不必要的declare关键字：

// 普通.ts文件中的正确写法
class Schedule {
  repeat?: Schedule.Repeat;
}

namespace Schedule {
  export class Repeat {
    // 普通方法实现完全没问题
    Hourly(): Repeat {
      return new Repeat();
    }

    Daily(): Repeat {
      return new Repeat();
    }

    // 访问器也可以正常用，因为这是实现代码，不是环境声明
    get Weekly(): Repeat {
      return new Repeat();
    }
  }
}

// 测试使用
const mySchedule = new Schedule();
mySchedule.repeat = new Schedule.Repeat().Hourly();

2. 如果是在.d.ts文件中写类型声明 #

如果你确实需要在声明文件中定义嵌套类的类型，只写类型结构，不写实现：

// .d.ts文件中的正确声明
declare class Schedule {
  repeat?: Schedule.Repeat;
}

declare namespace Schedule {
  export class Repeat {
    // 只声明方法的签名，不写函数体
    Hourly(): Repeat;
    Daily(): Repeat;
    // 访问器也只声明类型
    get Weekly(): Repeat;
  }
}

总结一下 #

你遇到的问题本质是「类型声明」和「代码实现」的场景混淆了：

• 写业务逻辑就用普通.ts文件，直接写实现代码
• 写类型声明就用.d.ts文件，只定义结构不写实现
• 不要随便加declare关键字，除非你明确知道自己在做类型声明

内容的提问来源于stack exchange，提问作者Kyle V.