用 Microsoft.Data.Sqlite
建立基础连接
这是目前 .NET 5+ 官方推荐的方式，替代了已废弃的
System.Data.SQLite。它轻量、跨平台、与 EF Core 深度集成。
先通过 NuGet 安装包：
Microsoft.Data.Sqlite（注意不是
System.Data.SQLite）。
连接字符串最简形式就是文件路径：
string connectionString = "Data Source=app.db";
如果数据库文件不存在，
SqliteConnection.Open()会自动创建它——这点和 SQL Server 不同，不用提前建库。
SqliteConnection
的典型使用模式
必须显式调用
Open()才真正建立连接；不支持连接池（SQLite 是文件级锁，连接池意义不大）。 总是用
using确保
Dispose()被调用，否则可能残留文件锁 不要长期持有打开的连接——SQLite 并发写入能力弱，长时间打开反而容易阻塞 读多写少场景下，可以复用同一个
SqliteConnection实例，但别跨线程共享
示例：
using var conn = new SqliteConnection("Data Source=app.db");
conn.Open(); // 必须调用
using var cmd = conn.CreateCommand();
cmd.CommandText = "SELECT COUNT(*) FROM users";
var count = (long)cmd.ExecuteScalar();执行 DDL 或带参数的查询时要注意什么
SQLite 对大小写不敏感，但表名/列名仍建议统一风格；它没有原生的
datetime类型，常用
TEXT（ISO8601）、
INTEGER（Unix 时间戳）或
REAL（Julian 日）存储时间。
参数化查询必须用
@name形式，不能用
?占位符（虽然底层支持，但
Microsoft.Data.Sqlite的
SqliteParameter只认命名参数）：
cmd.CommandText = "INSERT INTO logs (message, created_at) VALUES (@msg, @ts)";
cmd.Parameters.AddWithValue("@msg", "started");
cmd.Parameters.AddWithValue("@ts", DateTimeOffset.Now.ToUnixTimeSeconds());常见坑：
插入null值时，用
DBNull.Value，别传 C# 的
null执行 DDL（如
CREATE TABLE）后，记得立即
COMMIT，否则后续查询可能看不到新结构 事务中若发生异常，需手动
Rollback()，
using不会自动回滚
EF Core + SQLite 的最小配置
如果你用 EF Core，直接注册
SqliteDbContextOptionsBuilder即可，无需手动管理连接：
services.AddDbContext<AppDbContext>(options =>
options.UseSqlite("Data Source=app.db"));注意两点：
EF Core 默认启用连接池，但 SQLite 不支持真正的连接池，所以实际是“连接复用”，行为上接近单例连接 迁移（migration）生成的 SQL 有时含 SQLite 不支持的语法（比如
ALTER COLUMN），需要手工调整
Up(MigrationBuilder)
首次运行前最好加个检查逻辑，避免因路径权限或只读文件系统导致静默失败。
SQLite 的“连接”本质是文件句柄，很多问题其实不是连接失败，而是路径不可写、扩展名被杀毒软件拦截、或者多个进程同时尝试写入同一文件——这些比连接字符串写错更难排查。
