C#怎么使用SQLite本地数据库_C#如何创建和连接db文件【新手教程】-C#.Net教程-PHP中文网

直接用 Microsoft.Data.Sqlite 更适合新手：无需本地 DLL、跨平台稳定、EF Core 官方推荐；连接字符串须用绝对路径并确保目录存在；建表必须显式执行 ExecuteNonQuery；插入后查询需复用同一连接或确保前连接已释放。

c#怎么使用sqlite本地数据库_c#如何创建和连接db文件【新手教程】

直接用 System.Data.SQLite 就能创建、连接、读写 SQLite 数据库文件，不需要安装服务、不用配环境变量，一个 .db 文件就是完整数据库。但新手常卡在包选错、连接字符串写崩、或第一次建表就报“no such table”——其实不是代码问题，是路径、权限或初始化顺序没对。

怎么装对的 NuGet 包：别选错 System.Data.SQLite 和 Microsoft.Data.Sqlite

Visual Studio 里搜 “SQLite”，会出来至少两个主流包：System.Data.SQLite（老牌、带本机 DLL、支持密码和 EF6）和 Microsoft.Data.Sqlite（轻量、纯 .NET Standard、推荐新项目）。新手建议优先用后者，原因很实在：

Microsoft.Data.Sqlite 不依赖本地 C 运行时，跨平台部署更稳，dotnet publish 后扔到 Linux/macOS 也能跑
它不自带加密支持（比如 Password=xxx），但避免了新手因填错密码参数导致连接静默失败
如果你项目已用 EF Core，Microsoft.Data.Sqlite 是官方首选驱动，System.Data.SQLite 的 EF6 支持已基本停更

装法统一：打开包管理器控制台，执行 Install-Package Microsoft.Data.Sqlite。别手抖点到 System.Data.SQLite.Core —— 它要额外处理 x86/x64 架构匹配，新手第一反应往往是“为什么 Debug 能跑 Release 报错”。

连接字符串怎么写才不报错：路径必须绝对，且目录得存在

SQLite 连接字符串看着简单："Data Source=app.db"，但实际运行时容易栽在路径上。.NET 默认工作目录不一定是项目根目录，尤其在 WPF/WinForms 中双击 exe 启动时，当前目录可能是 C:\Windows\System32 —— 结果它真就在那建了个空 app.db，而你代码里查的却是项目目录下的同名文件。

正确做法是显式构造绝对路径：

string dbPath = Path.Combine(AppContext.BaseDirectory, "app.db");
string connectionString = $"Data Source={dbPath}";

还要注意：SQLite 不会自动创建父目录。如果路径是 data/app.db，得先确保 data 文件夹存在，否则 connection.Open() 会抛 SqliteException: unable to open database file。

小技巧：首次启动时主动检查并创建：

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

string dbPath = Path.Combine(AppContext.BaseDirectory, "data", "app.db");
Directory.CreateDirectory(Path.GetDirectoryName(dbPath)); // 确保目录存在
string connectionString = $"Data Source={dbPath}";

第一次建表就失败？先确认数据库文件是否真被创建

SQLite 不像 SQL Server 那样有“新建数据库”操作；它是在第一次执行 Open() 且文件不存在时，自动创建空文件。但这个文件只是个壳——没有表、没有 schema。很多人写了 CREATE TABLE 却没执行，或者执行了但没 commit（即没调 ExecuteNonQuery()），然后紧接着查表，自然报 no such table。

关键检查点：

用 File.Exists(dbPath) 确认文件是否存在（存在 ≠ 有表）
建表语句必须显式执行，不能只声明 command.CommandText
建表后建议加一句 PRAGMA table_info(YourTable) 查看是否成功

示例片段（确保建表生效）：

using var connection = new SqliteConnection(connectionString);
connection.Open();

using var command = connection.CreateCommand();
command.CommandText = @"
    CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        name TEXT NOT NULL,
        created_at TEXT DEFAULT (datetime('now'))
    )";
command.ExecuteNonQuery(); // 这行不能少

为什么插入后查不到数据？事务没提交或连接被提前释放

新手常把所有操作塞进一个 using 块里，以为“自动释放=自动保存”，但 SQLite 的默认行为是：每个命令单独成事务，除非显式开启 BeginTransaction。所以单条 INSERT 执行完就已落盘——问题往往出在“查的时候用了另一个连接实例”，而那个实例没看到刚插的数据，因为前一个连接还没关，或者用了不同的连接字符串（比如路径大小写不一致、相对路径解析不同）。

最稳妥的做法：