如何编写TypeScript接口以禁止访问类的未初始化属性？

你的核心问题在于类没有被接口正确约束，且TypeScript的严格初始化检查未生效，导致访问未初始化的this.material时没有触发错误。以下是具体的调整方案：

问题根源 #

1. 你定义的Collider接口和同名类没有通过implements关联，TypeScript不会自动用接口约束类的属性。
2. 类中没有显式声明接口定义的所有属性，TypeScript会隐式推断this.material为any类型，跳过初始化检查。
3. 未开启TypeScript的strictPropertyInitialization选项，即使声明了属性，也不会强制要求在构造函数中初始化。

调整步骤 #

1. 避免接口与类同名，明确实现接口 #

将描述类结构的接口改名（比如ColliderInterface），然后让类通过implements关键字绑定接口，强制类满足接口的所有属性约束。

2. 显式声明类的所有属性 #

在类中逐一声明接口定义的属性及其类型，让TypeScript可以检查属性的初始化状态。

3. 开启严格初始化检查 #

在tsconfig.json中启用strictPropertyInitialization（或直接开启strict: true，包含所有严格检查选项）：

{
  "compilerOptions": {
    "strict": true,
    // 或者单独开启：
    // "strictPropertyInitialization": true
  }
}

修正后的完整代码 #

interface ColliderConstructorArgumentInterface {
    radius: number;
    position?: THREE.Vector3;
}

// 改名接口，避免与类冲突
export interface ColliderInterface extends ColliderConstructorArgumentInterface {
    geometry: THREE.SphereGeometry;
    material: THREE.MeshBasicMaterial;
    mesh: THREE.Mesh;
    position: THREE.Vector3;
}

// 类明确实现接口
export class Collider implements ColliderInterface {
    // 显式声明所有接口属性
    radius: number;
    position: THREE.Vector3;
    geometry: THREE.SphereGeometry;
    material: THREE.MeshBasicMaterial;
    mesh: THREE.Mesh;

    constructor(settings: ColliderConstructorArgumentInterface) {
        this.radius = settings.radius;
        this.position = settings.position ?? new THREE.Vector3(0, 0, 0);
        
        // 先初始化material，再用于创建mesh
        this.material = new THREE.MeshBasicMaterial({ color: 0xffffff }); // 根据需求配置材质
        this.geometry = new THREE.SphereGeometry(this.radius, 8, 8);
        this.mesh = new THREE.Mesh(this.geometry, this.material);

        console.log(this);
    }
}

效果验证 #

调整后，如果你再忘记初始化material就直接使用this.material，TypeScript会立即抛出错误：Property 'material' has no initializer and is not definitely assigned in the constructor.，完全符合你想要的代码安全约束。

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