MyBatis官网首页第一屏就写着“MyBatis是网入支持定制化SQL、存储过程以及高级映射的网入持久层框架”。这句话我盯了三秒，网入脑子里只有一个念头：这年头，网入谁还在手写SQL？网入后来我被现实狠狠教育了——复杂报表、多表联查、网入数据库优化，网入JPA那套自动生成的网入SQL根本不够用。MyBatis的网入定位恰恰就是让你把SQL攥在自己手里。

官网设计得极其朴素，网入没有花哨的网入动画，没有弹窗引导。网入左侧导航栏从“简介”开始，网入一路铺到“动态SQL”“日志”“多数据库支持”。网入我第一次翻的网入时候觉得这文档也太干巴巴了，连个对比表格都不给。但用久了才明白，这种极简风格和MyBatis本身的调性完全一致——它不替你决定业务逻辑，只给你提供最直接的数据库操作通道。

看入门示例，第一步就是搞一个`SqlSessionFactory`。官网用XML配置数据源，然后通过`SqlSessionFactoryBuilder`构建工厂。这里有个细节特别有意思：官网特意强调“每个基于MyBatis的应用都是以一个SqlSessionFactory实例为中心的”。这句话翻译成人话就是——你所有数据库操作都得从这扇门进去。我见过不少新手在这里卡壳，因为不理解为什么要先搞个“工厂”，而不是直接new一个连接。其实你把它想象成线程池就通了：工厂负责管理会话生命周期，避免你每次操作都开新连接，那会把你数据库拖垮。

接着看映射器。官网推荐用Mapper接口绑定XML文件，接口里写方法签名，XML里写SQL语句。这种分离方式一开始让我很别扭——代码和SQL分家，找起来不累吗？但当你需要调整一条复杂查询时，好处立刻显现：你不用动Java代码，只改XML，重启就生效。而且MyBatis会帮你自动映射结果集，只要列名和属性名对得上。对不上的时候，官网也给了方案：用`resultMap`显式定义映射关系。这招在应对数据库命名规范混乱的老系统时，简直是救命稻草。

官网的入门文档里有个不起眼的小节叫“作用域和生命周期”。很多教程直接跳过这部分，但MyBatis官方偏偏把它放在显眼位置。`SqlSessionFactoryBuilder`用完就能扔，`SqlSessionFactory`要常驻，`SqlSession`是线程不安全的，只能用在方法内部。这些规则不遵守，轻则连接泄漏，重则并发错乱。我朋友的公司就踩过坑——他们把`SqlSession`当成员变量用，结果线上数据串了，排查了整整两天。

动态SQL那部分，官网用了一个“如果用户填了用户名就按用户名查，没填就查全部”的例子。``标签配合``标签，逻辑清晰得让人想鼓掌。这种场景在实际业务里太常见了，比如后台管理系统筛选条件，哪个字段有值就拼哪个条件。你用Java代码拼接字符串试试？分分钟被引号转义搞疯。MyBatis把这层脏活累活全包了，你只需要写几个XML标签。

最后说一点个人体会。MyBatis官网的入门文档就像一把钝刀——不锋利，但砍柴特别稳。它不会像某些框架那样给你画大饼，说“五分钟搞定CRUD”，它老老实实告诉你：你得写SQL，你得管理事务，你得关心连接。但正是这种“不装”的态度，让它在企业级项目里活得越来越好。如果你受够了JPA的玄学自动查询，或者对Spring Data JPA的复杂Specification感到头大，不妨耐着性子把官网入门走一遍。半小时功夫，你会发现自己对数据库的控制力回来了。