typescript严格模式下@prop()字段需显式初始化或用非空断言；类型映射遵循mongoose底层规则；嵌套对象须用独立class声明；nestjs中需用getmodelforclass(user)注册模型。
为什么直接用Typegoose装饰器会报 Property 'xxx' has no initializer？
这是 TypeScript 严格模式下的典型报错，Typegoose 的 @prop() 不会自动注入属性初始化逻辑，TS 编译器看到类属性没赋值就直接报错。不关掉 strictPropertyInitialization —— 那会掩盖真正的问题。
正确做法是显式初始化所有带 @prop() 的字段（哪怕只是 undefined）：
@prop({ required: true })
name: string = undefined;
@prop({ default: [] })
tags: string[] = [];
或者用非空断言（仅限你**100% 确保运行时有值**的场景，比如靠中间件或构造函数填充）：
@prop({ required: true })
email!: string;
注意：! 只绕过 TS 检查，不改变运行时行为；MongoDB 仍按 schema 定义校验。
@prop() 和原生 Mongoose Schema.Types 怎么对应？
Typegoose 把大部分常用类型做了封装，但底层还是走 Mongoose 的类型系统。别硬套 JS 原生类型——比如 number 对应的是 Schema.Types.Number，不是浮点数精度控制开关。
常见映射关系：
-
@prop() age: number→ MongooseNumber（可存整数/小数） -
@prop() createdAt: Date→ 自动转为Schema.Types.Date，且默认启用timestamps: true时无需额外配置 -
@prop({ type: () => [String] }) roles: string[]→ 显式声明数组元素类型，避免 Typegoose 推导成mixed -
@prop({ ref: () => User }) author: Ref<user></user>→ 必须用Ref<t></t>类型，且确保User已被@modelOptions()注册
嵌套对象和子文档怎么写才不会丢数据？
Typegoose 对嵌套对象支持较弱，纯 JS 对象字面量容易被忽略字段或丢失 validator。稳妥方式是：为每个子结构单独定义 class，并用 @prop({ type: () => SubDocClass }) 显式绑定。
例如用户地址：
class Address {
@prop()
street: string = '';
@prop()
city: string = '';
}
class User {
@prop({ type: () => Address })
address?: Address;
}
⚠️ 注意：不要写 address: { street: string; city: string } —— 这种匿名结构 Typegoose 无法生成有效 schema，存进 MongoDB 后字段可能消失或变成 mixed。
如果子文档要独立查询或索引，建议拆成独立 collection + ref，而不是强行嵌套。
NestJS 中注册 Model 时 forFeature() 报 Cannot determine the type
这个错误几乎都因为 Typegoose 没拿到类的运行时类型信息，根源在编译选项或 import 方式。
检查以下几点：
- 确保
tsconfig.json启用了"emitDecoratorMetadata": true和"experimentalDecorators": true - 所有 model class 必须用
export class Xxx extends TimeStamps形式导出，不能包裹在函数或条件块里 - 在 module 的
imports中，forFeature([{ name: User.name, schema: User }])写法是错的 ——User是 class，不是 schema；应该用getModelForClass(User)（来自@typegoose/typegoose） - 推荐写法：
import { getModelForClass } from '@typegoose/typegoose';
@Module({
imports: [
MongooseModule.forFeature([
{ name: User.name, model: getModelForClass(User) }
])
]
})
如果用了 @modelOptions({ schemaOptions: { timestamps: true } })，记得 getModelForClass() 才会把该配置注入到最终 schema 中。
嵌套引用、联合索引、自定义 validator 这些高级能力，Typegoose 都得靠装饰器参数一层层透传，漏一个配置项，运行时就静默失效 —— 多打日志看生成的 schema 结构，比猜更可靠。
