EF Core怎么连接SQLite EF Core连接SQLite数据库方法

来源:这里教程网 时间:2026-02-21 17:35:15 作者:

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<User> Users { get; set; }
<pre class="brush:php;toolbar:false;">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 就算跑起来了。

相关推荐