深入理解 MyBatis-Plus 的 `BaseMapper`

在使用 MyBatis-Plus（简称 MP）时，开发者几乎一定会接触到 BaseMapper 接口。它是 MP 的核心功能之一，提供了单表的基础 CRUD 操作，极大地减少了样板代码的编写工作。本文将详细介绍 BaseMapper 的作用、常用方法、源码解析以及最佳实践。

1. BaseMapper 简介

BaseMapper 是 MyBatis-Plus 提供的一个 通用 Mapper 接口 ，泛型参数 T 指定实体类类型。

它的设计初衷是：让开发者无需编写 XML 或额外的 SQL，即可直接使用基础的 增删改查方法。

定义位置

java

复制代码

package com.baomidou.mybatisplus.core.mapper;

public interface BaseMapper extends Mapper {

// 内置了丰富的 CRUD 方法

}

只要你的 Mapper 接口继承了 BaseMapper，并指定了对应的实体类，就能直接调用这些 CRUD 方法。例如：

java

复制代码

@Mapper

public interface UserMapper extends BaseMapper {

}

2. 常用方法一览

BaseMapper 内置了近 20 个常用方法，主要涵盖了 增、删、改、查。

（1）插入

java

复制代码

int insert(T entity);

功能：插入一条记录

特点：只插入非 null 字段，支持自增主键回填

（2）删除

java

复制代码

int deleteById(Serializable id);

int deleteByMap(@Param(Constants.COLUMN_MAP) Map columnMap);

int delete(@Param(Constants.WRAPPER) Wrapper wrapper);

int deleteBatchIds(@Param(Constants.COLL) Collection idList);

deleteById：根据主键删除

deleteBatchIds：批量删除

deleteByMap ：通过 Map<列名, 值> 删除

delete(Wrapper)：条件删除（支持 LambdaQueryWrapper）

（3）更新

java

复制代码

int updateById(@Param(Constants.ENTITY) T entity);

int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper updateWrapper);

updateById：根据主键更新，null 值字段会被更新为 null

update ：条件更新，配合 UpdateWrapper 使用

（4）查询

java

复制代码

T selectById(Serializable id);

List selectBatchIds(@Param(Constants.COLL) Collection idList);

List selectByMap(@Param(Constants.COLUMN_MAP) Map columnMap);

T selectOne(@Param(Constants.WRAPPER) Wrapper queryWrapper);

Integer selectCount(@Param(Constants.WRAPPER) Wrapper queryWrapper);

List selectList(@Param(Constants.WRAPPER) Wrapper queryWrapper);

List> selectMaps(@Param(Constants.WRAPPER) Wrapper queryWrapper);

List