如何在Visual Studio Code中为ASP.NET Core 6 MVC应用连接SQLite文件？

1. 正确配置数据库文件 #

• 将SQLite数据库文件（如YourDb.db）放在项目根目录，右键文件在VS Code中设置复制到输出目录为如果较新则复制；也可以直接修改项目.csproj文件添加配置：

<ItemGroup>
  <None Update="YourDb.db">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

• 若文件放在子目录（如Data文件夹），路径需对应调整。

2. 配置正确的连接字符串 #

在appsettings.json中写入准确的连接字符串：

"ConnectionStrings": {
  "DefaultConnection": "Data Source=YourDb.db;"
}

文件在子目录时，路径改为Data Source=Data/YourDb.db;（跨平台推荐用/，Windows也可兼容）。

3. 安装依赖NuGet包 #

在项目根目录终端执行，确保安装SQLite EF Core驱动：

dotnet add package Microsoft.EntityFrameworkCore.Sqlite

4. 配置DbContext #

方式一：在DbContext类中配置 #

using Microsoft.EntityFrameworkCore;

public class YourDbContext : DbContext
{
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        var config = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json")
            .Build();

        optionsBuilder.UseSqlite(config.GetConnectionString("DefaultConnection"));
    }

    // 定义你的实体集合
    public DbSet<YourEntity> YourEntities { get; set; }
}

方式二：在Program.cs中注入（ASP.NET Core 6顶级语句） #

var builder = WebApplication.CreateBuilder(args);

// 注入DbContext
builder.Services.AddDbContext<YourDbContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("DefaultConnection")));

// 其他服务配置...

var app = builder.Build();

// 中间件配置...

app.Run();

5. 验证连接 #

在Program.cs中添加初始化代码快速验证：

using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
    try
    {
        dbContext.Database.OpenConnection();
        Console.WriteLine("数据库连接成功！");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"连接失败：{ex.Message}");
    }
}

常见排查点 #

• 检查路径拼写，Linux/macOS环境注意大小写区分
• 确认数据库文件未被其他进程占用（如SQLite可视化工具）
• 排查运行时的文件读写权限问题

内容的提问来源于stack exchange，提问作者Flamez Wid