如何配置Linq2Db T4 POCO生成，在Npgsql+PostgreSQL环境下用NodaTime类型替换System.DateTime生成模型

前置依赖校验 #

• 项目需提前安装所需NuGet包：linq2db.T4、linq2db.PostgreSQL、Npgsql.NodaTime、NodaTime
• Npgsql连接字符串需添加Include=NodaTime参数，确保驱动层支持NodaTime类型的读写转换，避免运行时类型不匹配

T4模板核心配置 #

找到项目中用于自动生成POCO的Linq2Db T4模板脚本，在完成数据库元数据读取（执行完连接数据库、拉取表结构的代码段）之后、实体代码渲染生成之前，插入类型映射替换逻辑：

// 遍历所有列的默认映射规则，替换为NodaTime对应类型
dataModel.GetObject<ColumnMapping>().ForEach(column =>
{
    // 带时区时间戳（PostgreSQL timestamptz）对应 NodaTime Instant
    if (column.DataType == DataType.TimestampTz || column.DataType == DataType.Timestamp)
    {
        column.Type = nameof(Instant);
        column.AddRequiredUsings("NodaTime");
    }
    // 纯日期类型（PostgreSQL date）对应 LocalDate
    if (column.DataType == DataType.Date)
    {
        column.Type = nameof(LocalDate);
        column.AddRequiredUsings("NodaTime");
    }
    // 纯时间类型（PostgreSQL time）对应 LocalTime
    if (column.DataType == DataType.Time)
    {
        column.Type = nameof(LocalTime);
        column.AddRequiredUsings("NodaTime");
    }
    // 固定偏移时间类型对应 OffsetDateTime
    if (column.DataType == DataType.DateTimeOffset)
    {
        column.Type = nameof(OffsetDateTime);
        column.AddRequiredUsings("NodaTime");
    }
    // 时间间隔类型（PostgreSQL interval）对应 Period
    if (column.DataType == DataType.Interval)
    {
        column.Type = nameof(Period);
        column.AddRequiredUsings("NodaTime");
    }
});

注意：替换规则基于Linq2Db解析的数据库列数据类型匹配，不会误替换非数据库映射的自定义CLR类型，可空列会自动生成对应的可空NodaTime类型（如Instant?），无需额外处理。

运行时配置校验 #

生成实体后，确保数据上下文初始化时启用Npgsql的NodaTime支持：

// 数据连接初始化示例
var connection = new PostgreSqlDataConnection(connectionString, options => 
    options.UseNodaTime());

常见踩坑点 #

• 不要把类型替换逻辑写在代码渲染阶段，必须放在元数据加载完成后的模型预处理阶段，否则规则不生效
• 无需手动在生成的实体文件中补NodaTime的using引用，配置AddRequiredUsings后，T4会自动把命名空间加到实体文件的引用列表里
• 不要全局替换所有名称带DateTime的类型，严格按DataType枚举匹配，避免把业务侧自定义的非时间字段类型误替换

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