C# Model命令生成数据库表实战指南：从零到生产环境部署

1次阅读

没有评论

共计 2104 个字符，预计需要花费 6 分钟才能阅读完成。

在传统开发中，我们常常遇到以下问题：

手动编写 SQL 脚本创建数据库表，耗时且容易出错
模型类修改后，需要手动同步数据库结构，容易遗漏
团队成员之间数据库结构不一致，导致运行时报错
缺乏版本控制，难以追踪数据库结构变更历史

Entity Framework Core 提供了三种主要的工作流：

Code First
优点：完全面向对象，模型驱动，易于版本控制
缺点：需要学习迁移命令，对复杂数据库支持有限
Database First
优点：从现有数据库生成模型，适合已有数据库项目
缺点：模型更新需要重新生成，可能丢失自定义代码
Model First
优点：可视化设计器，适合快速原型开发
缺点：生成的代码可能不够灵活，维护成本高

对于新项目，推荐使用 Code First 方式，它提供了最好的开发体验和可维护性。

首先创建一个简单的 Product 模型：

public class Product
{
    // 主键，自增
    public int Id {get; set;} 

    // 商品名称，必填，最大长度 100
    [Required]
    [MaxLength(100)]
    public string Name {get; set;}

    // 价格，精度 18 位，小数 2 位
    [Column(TypeName = "decimal(18,2)")]
    public decimal Price {get; set;}

    // 库存数量
    public int Stock {get; set;}

    // 上架时间
    public DateTime ListedDate {get; set;} = DateTime.Now;
}

创建应用 DbContext 类：

public class AppDbContext : DbContext
{public DbSet<Product> Products { get; set;}

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 使用 SQL Server 数据库，连接字符串应从配置读取
        optionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=MyShop;Trusted_Connection=True;");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 使用 Fluent API 进行高级配置
        modelBuilder.Entity<Product>()
            .Property(p => p.Name)
            .IsRequired()
            .HasMaxLength(100);

        modelBuilder.Entity<Product>()
            .Property(p => p.Price)
            .HasColumnType("decimal(18,2)");
    }
}

安装 Entity Framework Core 工具：

dotnet tool install --global dotnet-ef

添加初始迁移：

dotnet ef migrations add InitialCreate

更新数据库：

dotnet ef database update

将迁移文件 (.cs) 纳入源代码控制
每个环境 (dev/test/prod) 应使用独立的迁移历史
禁止直接修改已应用的迁移

// 在 DbContext 中重写 ConfigureConventions 方法
protected override void ConfigureConventions(ModelConfigurationBuilder configurationBuilder)
{configurationBuilder.Properties<string>()
        .HaveMaxLength(100); // 全局设置字符串默认长度

    configurationBuilder.Properties<DateTime>()
        .HaveColumnType("datetime2"); // 统一使用 datetime2
}