前言

在开发桌面应用程序时，数据库是存储和管理数据的核心组件。对于中小型项目或本地应用，SQLite 是一个非常理想的选择。它轻量、无需安装服务器、部署简单，并且与 WinForm 配合良好。

本文将一步步了解如何在 WinForm 项目中集成 SQLite 数据库，并结合 SqlSugar ORM 框架 实现高效的数据操作，包括连接数据库、建表、插入、查询等核心功能。

#WinForm开发技巧

#SQLite数据库

一、SQLite 简介

SQLite 是一种嵌入式的轻量级关系型数据库系统，适用于资源有限的环境，如桌面应用、移动应用和小型 Web 应用。

✅ SQLite 的主要特点：

二、SQLite 下载与安装（Windows 平台）

1、打开 SQLite 官网；

2、根据系统选择合适的版本下载（推荐 sqlite-tools-win32-x86-*.zip）；

3、解压压缩包后，你会看到如下几个可执行文件：

sqlite3.exe：命令行工具

4、将解压目录添加到系统环境变量 PATH 中；

5、打开命令提示符输入 sqlite3，若出现如下内容表示安装成功。

三、创建 SQLite 数据库（使用 Navicat）

Navicat 是一款强大的数据库管理工具，支持 SQLite、MySQL、PostgreSQL 等多种数据库。

步骤如下

1、打开 Navicat，点击【新建连接】 → 【SQLite】；

2、输入连接名，选择"新建 SQLite 数据库"；

3、设置数据库保存路径（建议放在项目目录下，便于维护）；

4、创建完成后，会在指定路径生成 .db 文件，即为 SQLite 数据库文件。

四、在 WinForm 项目中使用 SqlSugar 操作 SQLite

1、安装 SqlSugar

打开 Visual Studio，进入 NuGet 包管理器，搜索并安装以下包（根据 .NET 版本选择）：

如果是 .NET Core 或 .NET 5/6/7/8，安装 SqlSugarCore

如果是 .NET Framework，则安装 SqlSugar

2、配置数据库连接字符串

// 获取当前程序启动路径 + 数据库文件名
public static string SQLitePath = Application.StartupPath + "\\demo.db";
public static string ConnectionString = "Data Source=" + SQLitePath;

// 初始化 SqlSugarClient
var db = new SqlSugarClient(new ConnectionConfig()
{
    DbType = DbType.Sqlite,
    ConnectionString = ConnectionString,
    IsAutoCloseConnection = true
});

⚠️ 注意：Application.StartupPath 和 Environment.CurrentDirectory 通常指向项目编译后的 bin\Debug 或 bin\Release 目录。

3、创建实体类

在项目中创建一个 Student 类，用于映射数据库表：

public class Student
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }

    public string? Name { get; set; }
}

4、使用 Navicat 在 SQLite 中建表

在 Navicat 中手动创建一张名为 Student 的表，字段包括：

• Id（主键、自增）

• Name（文本类型）

5、编写 WinForm 窗体代码测试插入数据

在窗体中添加一个按钮，并编写如下事件处理逻辑：

private void button1_Click(object sender, EventArgs e)
{
    var student = new Student();
    student.Name = "小明";

    db.Insertable(student).ExecuteCommand(); // 插入数据
}

运行程序后，在 Navicat 中查看数据库，确认数据已成功写入。

五、总结

本文详细介绍了如何在 WinForm 项目中使用 SQLite 数据库，并结合 SqlSugar ORM 实现了数据库连接、表结构定义、数据插入等基础操作。SQLite 的轻量化和易用性使其成为中小型 WinForm 应用的理想选择。

优势

部署简单，无需安装数据库服务器；

单文件存储，易于备份和迁移；

结合 SqlSugar 可快速实现数据操作；

适合桌面应用、嵌入式系统、原型开发等场景。