Microsoft.Data.Sqlite是.NET 6+项目唯一稳妥选择，因其由微软官方维护、内嵌跨平台sqlite3、无需手动部署DLL，而System.Data.SQLite多年未维护且易因RID不匹配报错。
直接用 Microsoft.Data.Sqlite，别碰 System.Data.SQLite —— 后者已多年未维护，.NET 6+ 项目在 Windows/macOS/Linux 上都可能因原生依赖失败而报 DllNotFoundException 或 Unable to load DLL 'sqlite3'。
为什么 Microsoft.Data.Sqlite 是当前唯一稳妥选择
Microsoft.Data.Sqlite 是微软官方维护的 SQLite ADO.NET 提供程序，内嵌跨平台 sqlite3 二进制（通过 SQLitePCLRaw），无需手动部署 DLL，也不依赖系统级 sqlite3 安装。它完全兼容 .NET Standard 2.0+ 和所有现代 .NET（.NET 5/6/7/8/9），且 API 与标准 ADO.NET 一致，迁移成本低。
而 System.Data.SQLite 仍基于旧版 sqlite3.dll 绑定，其 NuGet 包（如 System.Data.SQLite.Core）在 .NET 6+ 中常因运行时标识（rid）不匹配导致构建失败或运行时报错，尤其在 CI/CD 或 macOS/Linux 构建环境下极难排查。
- 新项目一律用
Microsoft.Data.Sqlite - 已有项目若用
System.Data.SQLite且无异常，可暂不改；但一旦遇到部署失败、多平台打包问题或升级 .NET 版本，必须切换 -
Microsoft.Data.Sqlite不支持自定义sqlite3编译选项（如 FTS5、JSON1 扩展），如需这些，得自行编译并替换SQLitePCLRaw.lib.sqlcipher等底层包——普通业务几乎用不到
连接字符串和数据库文件路径怎么写才不踩坑
SQLite 数据库就是一个文件，路径写错 = 创建空库 / 找不到表 / 操作了别的库。关键点是：路径必须是**绝对路径**，且目录需存在；相对路径在不同启动方式（IDE 调试 / 命令行 / 发布后执行）下行为不一致。
- 正确写法：
"Data Source=" + Path.GetFullPath("app.db")，或硬编码为"Data Source=C:\myapp\data\app.db" - 错误写法：
"Data Source=app.db"（IDE 下可能工作，发布后大概率连到 bin 目录下的另一个空文件） - 如果路径含中文或空格，不用额外转义，
Microsoft.Data.Sqlite内部已处理 - 首次连接时，若文件不存在会自动创建；但目录必须存在，否则抛
DirectoryNotFoundException
执行 INSERT/UPDATE/DELETE 时要不要用事务
单条语句默认自动提交，但实际开发中几乎总是需要显式事务——否则批量操作中途失败会导致数据不一致，且无法回滚。
- 即使只执行一条
INSERT，也建议包裹在using var tx = conn.BeginTransaction()中，便于后续扩展 - 批量插入 100 条记录时，把所有
command.ExecuteNonQuery()放在同一个事务里，性能提升 5–10 倍（磁盘刷写次数从 100 次降到 1 次） - 注意：事务中所有
command必须共用同一个connection实例，且command.Transaction必须显式赋值，不能只靠conn.BeginTransaction()自动绑定 - 示例关键行：
command.Transaction = tx;—— 少这句，事务无效
读取查询结果时 DataReader 和 ToList() 怎么选
SqliteDataReader 是流式读取，内存占用恒定；ToList()（配合 SqliteCommand.ExecuteReader() + 手动映射）或 EF Core 的 AsEnumerable() 会一次性加载全部结果到内存。
- 查几百条以内、字段少的数据（如配置项、用户列表），用
ToList()更简洁 - 查日志、报表等可能返回数万行的数据，必须用
SqliteDataReader+while (reader.Read())，否则容易 OOM -
reader["column_name"]比reader.GetInt32(0)更安全（列顺序变化不影响），但略慢；对性能敏感场景（如高频统计循环）可改用索引访问 - 别在
using (var reader = cmd.ExecuteReader())外部访问reader—— 连接关闭后 reader 自动释放，再读会抛InvalidOperationException
最易被忽略的一点：SQLite 的 DateTime 默认以 TEXT 存储（ISO8601 格式），不是 ticks 或 JulianDay。如果你用 DateTime.Now 插入再读取，值虽正确，但类型其实是 string；要强制按整数存储需在建表时指定 INTEGER 类型并手动转换——多数场景保持默认 TEXT 即可，语义清晰且跨平台兼容性好。
