在 typeorm 中，若需将结构化对象数组（如包含 icon 和 main 字段的 icons 列表）直接存储于实体中，推荐使用 jsonb 类型（postgresql）或 json 类型（其他数据库），配合 typescript 接口定义类型安全，避免冗余关联表。
当业务模型中某个字段天然表现为「一组结构化对象」（例如每个条目包含 icon: string 和 main: boolean），且该数组不需独立查询、关联或频繁更新单个子项时，将数组作为内联 JSON 字段存储是最简洁、高效的设计方案。TypeORM 支持原生 JSON/JSONB 类型映射，可完整保留嵌套结构与类型语义。
✅ 正确实现方式（推荐）
首先定义类型接口，确保 TypeScript 编译时类型安全：
// icons.interface.ts
export interface Icon {
icon: string;
main: boolean;
}然后在实体中使用 @Column({ type: 'jsonb' })（PostgreSQL）或 @Column({ type: 'json' })（MySQL 5.7+/SQLite/SQL Server）：
// article.entity.ts
import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';
import { Icon } from './icons.interface';
@Entity()
export class Article {
@PrimaryGeneratedColumn()
id: number;
@Column()
title: string;
@Column({
type: 'jsonb', // PostgreSQL 推荐；MySQL 用 'json'
nullable: true,
default: () => '[]' // 注意：函数形式确保每次新建实例获得独立空数组
})
icons: Icon[];
}⚠️ 关键细节：default: () => '[]' 而非 default: []，避免多个实例共享同一引用数组，引发意外数据污染。
? 使用示例
// 创建并保存
const article = new Article();
article.title = 'Title text';
article.icons = [
{ icon: 'icon-1.png', main: true },
{ icon: 'icon-2.png', main: false },
{ icon: 'icon-3.png', main: false }
];
await repository.save(article);查询后，article.icons 将自动反序列化为 Icon[] 类型数组，可直接解构、遍历或校验：
const saved = await repository.findOneBy({ id: 1 });
console.log(saved.icons[0].icon); // "icon-1.png"
console.log(Array.isArray(saved.icons)); // true❌ 不推荐场景（何时不用 JSON 字段）
- 需要按 icons.main = true 独立查询文章；
- 需要对 icon 字段建立索引或全文搜索；
- icons 数据量极大（> 1MB）或频繁单独更新某一项；
- 需与其他实体（如 User、Category）建立多对多关系。
此时应拆分为独立实体 + @OneToMany / @ManyToOne 关系映射。
✅ 总结
- 轻量、静态、读多写少的嵌套对象数组 → 用 jsonb/json 字段，开发快、维护简、性能优；
- 配合 TypeScript 接口保障类型安全；
- 注意 default 使用函数返回值，防止引用共享；
- 生产环境务必在数据库层面验证 JSON 格式（如 PostgreSQL 的 CHECK (icons @> '[]'::jsonb)）以增强健壮性。
