EF Core 连接 SQLite 仅需三步:安装 Microsoft.EntityFrameworkCore.Sqlite 和 Microsoft.EntityFrameworkCore.Tools 包;定义继承 DbContext 的类并重写 OnConfiguring 使用 UseSqlite 配置数据库路径;调用 EnsureCreated() 或迁移命令建库建表。

EF Core 连接 SQLite 很简单,核心就三步:装包、建上下文、配连接字符串。不需要安装服务、不用配置文件、也不用额外启动进程——SQLite 本身就是文件型数据库,连上即用。
安装必要的 NuGet 包
项目中至少要引入这两个包(.NET 6 及以上推荐用最新稳定版,如 8.x 或 9.x):
- Microsoft.EntityFrameworkCore.Sqlite(主提供程序,含运行时和基础适配)
-
Microsoft.EntityFrameworkCore.Tools(可选,用于迁移命令,如
dotnet ef migrations add)
如果用 .NET 8+,一般不需要手动装 SQLitePCLRaw 系列包,新版 Microsoft.EntityFrameworkCore.Sqlite 已内置依赖。若编译报错缺 sqlite3,再补装 SQLitePCLRaw.bundle_e_sqlite3。
定义 DbContext 并配置 SQLite 连接
新建一个继承自 DbContext 的类,重写 OnConfiguring 方法,用 UseSqlite 指定数据库路径:
public class AppDbContext : DbContext
{
public DbSet Users { get; set; }
protected override void OnConfiguring(DbContextOptionsBuilder options)
=> options.UseSqlite("Data Source=app.db"); // 相对路径,生成在输出目录}
更稳妥的做法是用绝对路径,避免发布后找不到文件:
- 开发时可放
bin/Debug 下;发布后建议放在程序根目录或 AppData 等用户数据目录
- 例如:
Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "myapp.db")
创建表并初始化数据库
EF Core 不会自动建库建表,需主动触发:
- 调用
dbContext.Database.EnsureCreated():一次性建库建表(适合原型或无迁移场景)
- 或使用迁移(推荐长期项目):
dotnet ef migrations add InitialCreate
dotnet ef database update
注意:SQLite 不支持所有 SQL Server 的迁移操作(如重命名列、删除主键),复杂变更建议手动写 SQL 或用 SqliteConnection 辅助处理。
使用时的实用提醒
SQLite 是单文件、无服务器、零配置,但也带来几个常见坑点:
-
并发写入限制:同一时间只允许一个写操作,多线程写需加锁或用连接池控制
-
不支持默认值表达式(如
CURRENT_TIMESTAMP)需在 C# 层赋值,或用 HasDefaultValueSql 显式声明
-
大小写敏感:SQLite 默认不区分大小写,但表名/列名映射仍建议保持一致(靠
[Column("xxx")] 显式指定更稳)
-
发布部署别忘带 .db 文件:调试时生成在
bin/Debug,发布后要确保 app.db 在程序运行目录下,否则报“找不到数据库”
基本上就这些。连得上、建得表、读得数据,SQLite + EF Core 就算跑起来了。










