Object literals cannot be used as type declarations (arkts-no-obj-literals-as-types) <ArkTSCheck>

Object literals cannot be used as type declarations (arkts-no-obj-literals-as-types) 是 ArkTS 编译器的一项类型检查规则，它禁止直接使用对象字面量来声明类型。在 ArkTS 里，对象字面量只能用于创建对象实例，而不能用来定义类型。如果你需要定义类型，应该使用接口（interface）或者类型别名（type）。

错误示例

下面这些代码会触发这个错误：

// 错误：直接使用对象字面量作为类型
function greet(person: { name: string; age: number }) {
    console.log(`Hello, ${person.name}`);
}

// 错误：在类型注解中使用对象字面量
const person: { name: string; age: number } = {
    name: 'Alice',
    age: 30
};

解决办法

1. 使用接口（Interface）

接口是定义对象类型的首选方式，它清晰地描述了对象的结构。

// 定义接口
interface Person {
    name: string;
    age: number;
}

// 使用接口作为类型
function greet(person: Person) {
    console.log(`Hello, ${person.name}`);
}

const person: Person = {
    name: 'Alice',
    age: 30
};

2. 使用类型别名（Type Alias）

类型别名可以定义各种类型，包括对象类型、联合类型等。

// 定义类型别名
type Person = {
    name: string;
    age: number;
};

// 使用类型别名作为类型
function greet(person: Person) {
    console.log(`Hello, ${person.name}`);
}

const person: Person = {
    name: 'Alice',
    age: 30
};

3. 内联类型注解（谨慎使用）

如果类型只在局部使用一次，并且结构简单，可以使用内联类型注解，但要确保符合代码规范。

// 正确：使用内联类型注解，但仅适用于简单场景
function greet(person: { name: string; age: number }) {
    console.log(`Hello, ${person.name}`);
}

最佳实践

1. 优先使用接口：对于公共 API 或者会被多处使用的类型，建议使用接口。
2. 使用类型别名处理复杂类型：当需要定义联合类型、交叉类型等复杂类型时，使用类型别名。
3. 避免内联类型注解：内联类型注解会降低代码的复用性和可读性，应尽量避免。

通过遵循这些规则，你可以解决 Object literals cannot be used as type declarations 错误，使代码更加规范和易于维护。