首次启动时填充SQLite本地数据库的优化方案咨询

这种硬编码几十条初始化数据的痛苦我太懂了——代码臃肿不堪，后续改个数据还要钻进业务逻辑类里，维护起来简直头疼。针对你的场景，我给你几个实用的优化方向，比单纯搞个专用程序集更能解决本质问题：

1. 把初始化数据移到配置文件（JSON/CSV），实现数据-代码分离 #

这是最直观的优化，把原本硬编码的25+对象放到独立的JSON或CSV文件里，然后写个简单的读取逻辑加载数据，完全不用动业务类。

举个例子，先创建initial-data.json文件（可以设为复制到输出目录）：

[
  {
    "Id": 1,
    "Name": "示例对象1",
    "Description": "这是第一个初始化对象"
  },
  {
    "Id": 2,
    "Name": "示例对象2",
    "Description": "这是第二个初始化对象"
  }
]

然后在你的初始化逻辑里读取并插入：

// 假设你用EF Core操作SQLite
using var dbContext = new YourDbContext();

// 检查是否已经初始化过，避免重复执行
if (!dbContext.YourEntities.Any())
{
    var jsonContent = File.ReadAllText("initial-data.json");
    var initialItems = JsonSerializer.Deserialize<List<YourEntity>>(jsonContent);
    
    // 批量插入+事务优化性能
    using var transaction = dbContext.Database.BeginTransaction();
    dbContext.YourEntities.AddRange(initialItems);
    await dbContext.SaveChangesAsync();
    transaction.Commit();
}

这种方式的好处是：修改数据不用改代码，直接编辑JSON文件就行；数据结构清晰，新增对象也只需要加JSON节点。

2. 用嵌入式SQL脚本执行初始化 #

如果你的初始化逻辑更适合直接用SQL操作（比如有复杂的关联数据），可以把INSERT脚本做成嵌入式资源，启动时读取并执行。

步骤：

• 创建init-db.sql文件，写入所有INSERT语句：

INSERT INTO YourEntities (Id, Name, Description) VALUES (1, '示例对象1', '描述1');
INSERT INTO YourEntities (Id, Name, Description) VALUES (2, '示例对象2', '描述2');

• 在文件属性里设置“生成操作”为嵌入式资源
• 读取资源并执行：

using var connection = new SQLiteConnection("你的连接字符串");
connection.Open();

// 检查是否已初始化
var count = connection.ExecuteScalar<int>("SELECT COUNT(*) FROM YourEntities");
if (count == 0)
{
    // 读取嵌入式脚本
    var assembly = Assembly.GetExecutingAssembly();
    var resourceName = "YourNamespace.init-db.sql";
    using var stream = assembly.GetManifestResourceStream(resourceName);
    using var reader = new StreamReader(stream);
    var sqlScript = reader.ReadToEnd();
    
    // 执行脚本
    connection.Execute(sqlScript);
}

3. 实现专用初始化类库（你的思路优化版） #

如果确实想把初始化逻辑完全独立出来，可以做一个单独的类库，但要明确职责：

• 类库只负责提供初始化数据和执行初始化逻辑，不依赖业务项目的其他逻辑
• 可以把配置文件（JSON/脚本）也放在类库里，作为嵌入式资源
• 对外暴露一个简单的入口方法，比如DbInitializer.InitializeAsync(YourDbContext dbContext)

示例类库结构：

DbInitializerLibrary/
├── InitialData/
│   └── initial-data.json（嵌入式资源）
├── DbInitializer.cs
└── DbInitializerLibrary.csproj

DbInitializer.cs的核心代码：

public static class DbInitializer
{
    public static async Task InitializeAsync(YourDbContext dbContext)
    {
        if (await dbContext.YourEntities.AnyAsync())
            return;
            
        var jsonContent = ReadEmbeddedResource("DbInitializerLibrary.InitialData.initial-data.json");
        var initialItems = JsonSerializer.Deserialize<List<YourEntity>>(jsonContent);
        
        await dbContext.YourEntities.AddRangeAsync(initialItems);
        await dbContext.SaveChangesAsync();
    }
    
    private static string ReadEmbeddedResource(string resourceName)
    {
        var assembly = Assembly.GetExecutingAssembly();
        using var stream = assembly.GetManifestResourceStream(resourceName);
        using var reader = new StreamReader(stream);
        return reader.ReadToEnd();
    }
}

然后在你的控制台应用里只需要一行调用：

await DbInitializer.InitializeAsync(dbContext);

额外注意事项 #

• 避免重复初始化：一定要加判断逻辑（比如检查表中是否有数据，或者新增一个DbVersion表记录初始化版本），防止每次启动都执行插入
• 性能优化：SQLite批量插入时一定要用事务，否则每一条INSERT都会触发一次磁盘IO，速度会很慢
• 数据版本管理：如果后续需要更新初始化数据，可以考虑用增量脚本+版本号的方式，比如记录当前初始化版本，下次启动时执行对应版本的增量脚本

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