本文将详细讲解在asp.net core webapi项目中，基于SqlSugarCore ORM框架实现PostgreSQL数据库的连接、配置、CRUD操作，适配.NET 6/.NET 7/.NET 8主流版本，全程无冗余配置，可直接落地项目。

提前安装PostgreSQL数据库，创建空数据库（示例数据库名：

），无需手动创建数据表，后续通过SqlSugarCore代码自动建表。同时记录数据库连接所需参数：地址、端口、数据库名、账号、密码。

通过Rider内置NuGet包管理器或NuGet控制台，安装以下两个核心包（适配PostgreSQL专属依赖）：

 版本，提供两种Rider安装方式（图形化安装+终端命令安装），可任选其一：

方式一：Rider可视化NuGet包管理器安装（推荐）

1. 在Rider右侧面板找到【NuGet】包管理工具，打开包搜索界面； 2. 在搜索框输入 

，检索对应组件； 3. 在版本下拉列表中，精准选择 

 固定版本； 4. 点击安装，等待Rider自动完成组件引入与引用配置。

打开Rider底部Terminal终端，切换到项目根目录，执行标准 .NET CLI 命令精准安装指定版本：

dotnet add package SqlSugarCore --version 5.1.4.214

中添加PostgreSQL数据库连接配置，替换为自己的数据库参数：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "ConnectionStrings": {
    "PgSqlConnection": "Host=localhost;Port=5432;Database=SqlSugarPgDb;Username=postgres;Password=123456;Pooling=true;Maximum Pool Size=100"
  },
  "AllowedHosts": "*"
}

参数说明：Host为数据库地址、Port默认5432、Database为目标库名、Username为数据库账号、Password为登录密码；Pooling开启连接池、Maximum Pool Size设置最大连接数，提升高并发下的性能。

中配置SqlSugar参数，注册为全局单例服务，适配PostgreSQL数据库，开启日志、自动建表等功能：

using SqlSugar;
using SqlSugarPgDemo.Extensions;
​
var builder = WebApplication.CreateBuilder(args);
​
// 注册控制器
builder.Services.AddControllers();
// 注册Swagger文档
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
​
// 注册SqlSugarCore服务
builder.Services.AddScoped<ISqlSugarClient>(sp =>
{
    var db = new SqlSugarClient(new ConnectionConfig()
    {
        // 数据库类型指定为PostgreSQL
        DbType = DbType.PostgreSQL,
        ConnectionString = builder.Configuration.GetConnectionString("PgSqlConnection"),
        // 开启自动释放数据库连接
        IsAutoCloseConnection = true,
        MoreSettings = new ConnMoreSettings()
        {
            PgSqlIsAutoToLower = false, // 是否自动转小写
            *PgSqlIsAutoToLowerCodeFirst = false, // CodeFirst时是否转小写
        }
    });
​
    // 开启SQL日志输出（控制台打印执行的SQL语句，方便调试）
    db.Aop.OnLogExecuting = (sql, pars) =>
    {
        Console.WriteLine($"执行SQL：{sql}\r\n参数：{string.Join(",", pars.Select(p => p.Value))}");
    };
​
    return db;
});
​
var app = builder.Build();
​
// 启用Swagger
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}
​
app.UseAuthorization();
app.MapControllers();
​
// 初始化数据库表
app.InitTables();
​
app.Run();

六、创建实体类（数据库表映射）

，SqlSugarCore可通过该实体自动生成数据库表：

using SqlSugar;
​
namespace SqlSugarPgDemo.Entity
{
    /// <summary>
    /// 用户实体（自动映射user表）
    /// </summary>
    [SugarTable("sys_user")] // 指定数据库表名
    public class User
    {
        /// <summary>
        /// 主键ID（自增）
        /// </summary>
        [SugarColumn(IsPrimaryKey = true, IsIdentity = true)] // 主键、自增
        public int Id { get; set; }
​
        /// <summary>
        /// 用户名
        /// </summary>
        [SugarColumn(Length = 50, IsNullable = false)] // 字段长度、非空
        public string UserName { get; set; } = string.Empty;
​
        /// <summary>
        /// 手机号
        /// </summary>
        [SugarColumn(Length = 11, IsNullable = true)]
        public string? Phone { get; set; }
​
        /// <summary>
        /// 创建时间
        /// </summary>
        [SugarColumn(IsNullable = true)]
        public DateTime? CreateTime { get; set; }
    }
}

配置字段属性（主键、自增、长度、是否为空），完美适配PostgreSQL字段规则。

七、项目启动自动初始化数据库表（扩展类方式）

方案，无需手动调用接口，通过自定义扩展类实现程序启动时自动根据实体类创建数据表，不存在则创建，已存在则忽略，适配PostgreSQL数据库。首先在项目中新建 

using SqlSugar;
using SqlSugarPgDemo.Entity;
using Microsoft.AspNetCore.Builder;
​
namespace SqlSugarPgDemo.Extensions;
​
public static class Extensions
{
    /// <summary>
    /// 项目启动初始化数据库表
    /// </summary>
    /// <param name="app"></param>
    public static void InitTables(this IApplicationBuilder app)
    {
        // 创建服务作用域，获取SqlSugarCore实例
        using var scope = app.ApplicationServices.CreateScope();
        var db = scope.ServiceProvider.GetRequiredService<ISqlSugarClient>();
​
        // 自动根据实体初始化数据表
        db.CodeFirst.InitTables<User>();
    }
}

扩展类编写完成后，已在前文Program.cs中引入调用 

，无需手动调用接口。在Rider中点击右上角运行按钮启动项目，程序启动完成后，会自动在PostgreSQL数据库中生成 sys_user 数据表，全程无需人工干预。

，实现新增、查询、修改、删除、分页查询等常用数据库操作：

using Microsoft.AspNetCore.Mvc;
using SqlSugar;
using SqlSugarPgDemo.Entity;
​
namespace SqlSugarPgDemo.Controllers;
​
[Route("api/**[controller]**")]
[ApiController]
public class UserController : ControllerBase
{
    private readonly ISqlSugarClient _db;
​
    public UserController(ISqlSugarClient db)
    {
        _db = db;
    }
​
    /// <summary>
    /// 新增用户
    /// </summary>
    [HttpPost("Add")]
    public async Task<IActionResult> AddUser([FromBody] User user)
    {
        user.CreateTime = DateTime.Now;
        int id = await _db.Insertable(user).ExecuteReturnIdentityAsync();
        return Ok($"新增成功，用户ID：{id}");
    }
​
    /// <summary>
    /// 根据ID查询用户
    /// </summary>
    [HttpGet("GetById/{id}")]
    public async Task<IActionResult> GetUserById(int id)
    {
        var user = await _db.Queryable<User>().InSingleAsync(id);
        return Ok(user);
    }
​
    /// <summary>
    /// 查询所有用户
    /// </summary>
    [HttpGet("GetAll")]
    public async Task<IActionResult> GetAllUser()
    {
        var list = await _db.Queryable<User>().ToListAsync();
        return Ok(list);
    }
​
    /// <summary>
    /// 分页查询用户
    /// </summary>
    [HttpGet("GetPage")]
    public async Task<IActionResult> GetPageUser(int pageIndex = 1, int pageSize = 10)
    {
        var pageData = await _db.Queryable<User>()
            .ToPageListAsync(pageIndex, pageSize);
        return Ok(pageData);
    }
​
    /// <summary>
    /// 修改用户信息
    /// </summary>
    [HttpPut("Update")]
    public async Task<IActionResult> UpdateUser([FromBody] User user)
    {
        int rows = await _db.Updateable(user).UpdateColumns(x => new { x.UserName, x.Phone }).ExecuteCommandAsync();
        return Ok($"修改成功，影响行数：{rows}");
    }
​
    /// <summary>
    /// 删除用户
    /// </summary>
    [HttpDelete("Delete/{id}")]
    public async Task<IActionResult> DeleteUser(int id)
    {
        int rows = await _db.Deleteable<User>().In(id).ExecuteCommandAsync();
        return Ok($"删除成功，影响行数：{rows}");
    }
}

通过以上完整步骤，已从零完成 asp.net core webapi + SqlSugarCore 5.1.4.214 + PostgreSQL 的基础整合配置。教程全程基于Rider开发环境，采用.NET CLI标准安装方式、规范的数据库连接配置、程序启动自动CodeFirst建表方案，同时实现了全套异步CRUD基础接口（新增、查询、修改、删除、分页查询）。SqlSugarCore完美适配PostgreSQL数据库特性，规避了大小写兼容、语法适配等常见坑，配置简洁、代码轻量化，满足项目基础数据库开发需求，可直接用于日常开发与项目落地。

本文完整实战项目代码已上传至码云Gitee，包含所有配置文件、实体类、扩展方法、CRUD接口，可直接克隆运行学习：

https://gitee.com/Peter_Mond/sql-sugar-pg-demo.git

仓库代码与本文教程完全同步，基于 Rider + asp.net core webapi + SqlSugarCore 5.1.4.214 + PostgreSQL 实现，开箱即用。

asp.net core webapi使用SqlSugarCore操作PostgreSQL数据库教程

后端

数据库

编程语言

ASP.NET Core WebAPI项目实战：使用SqlSugarCore ORM框架连接PostgreSQL数据库，适配.NET6/7/8版本。教程涵盖环境配置、NuGet包安装、数据库连接、实体类映射、自动建表及CRUD操作实现，解决PostgreSQL大小写兼容等常见问题，提供完整源码下载。

2026年中大促 | AI 领航 智绘未来

postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

asp.net core webapi使用SqlSugarCore操作PostgreSQL数据库教程

asp.net core webapi使用SqlSugarCore操作PostgreSQL数据库教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐