打开 mybatis.org 这个网站，第一眼看到的东西非常朴素。没有花哨的动画，没有铺天盖地的营销文案，就一个干净的导航栏加一段简短介绍。这跟国内很多技术框架官网的画风完全不同——不跟你绕弯子，直接告诉你 MyBatis 是什么、能干什么、怎么开始用。

说白了，MyBatis 就是一个 Java 持久层框架。它干的事核心只有一件：帮你把 SQL 和 Java 对象之间的映射关系管起来。跟 Hibernate 那种全自动 ORM 不一样，MyBatis 让你自己写 SQL，它负责把参数塞进去、把结果集捞出来映射成对象。这个定位决定了它的用户群——那些不想放弃 SQL 控制权、但又不想手写 JDBC 样板代码的开发者。

Getting Started 页面藏着不少细节

网站的 Getting Started 部分写得很实在。它没有一上来就甩一堆概念，而是直接给你一个可运行的例子。先加依赖，Maven 里扔一行 mybatis 的坐标，然后配一个 mybatis-config.xml，再写个 mapper 接口和对应的 XML 文件，最后跑一个 SqlSessionFactory 就能查出数据了。整个流程走下来，一个新手大概二十分钟能跑通。

我注意到一个细节：官网的示例代码用的是 Resources.getResourceAsStream() 来加载配置文件。这个方法在旧版本里很常见，现在很多人用 Spring Boot 集成之后基本碰不到了。但官网一直保留着这种最原始的用法，大概是想让你先理解 MyBatis 本身怎么运转，再去用上层封装。

XML 配置和注解，两条路都给了

MyBatis 支持两种写 SQL 的方式。一种是在 XML 文件里写 <select>、<insert> 这些标签，另一种是直接在接口方法上挂 @Select、@Insert 注解。官网对两种方式都有文档，但明显 XML 那部分的篇幅更重。这也合理——真正复杂的动态 SQL，比如 <if>、<foreach>、<choose> 这些标签组合起来，注解写起来会非常难受，XML 才是主场。

动态 SQL 这块是 MyBatis 的强项。官网上有个例子让我印象挺深：一个 <foreach> 标签处理批量插入，代码不长，但把 collection、item、separator、open、close 这几个属性的配合讲得很清楚。实际项目里做批量操作的时候，这段文档我翻过不止一次。

中文文档是个加分项

mybatis.org 有官方中文翻译。翻译质量不算完美，有些地方读起来能感觉到是直译的痕迹，但技术文档嘛，意思到位就行。相比某些框架的中文文档常年停留在旧版本，MyBatis 的中文页面更新还算及时，至少核心功能部分跟英文版对得上。

不过有个问题：官网的搜索功能不太好用。想找一个具体配置项的时候，用站内搜索经常搜不到精准结果，最后还得靠 Google 加 site:mybatis.org 来查。另外 GitHub 上的 issues 和 wiki 有时候比官网文档更新更快，特别是遇到版本兼容性问题的时候。

MyBatis-Plus 和 MyBatis 的关系

国内开发者绕不开 MyBatis-Plus。它是在 MyBatis 基础上做的增强，提供了大量开箱即用的 CRUD 方法，省去了写基础 SQL 的功夫。但 mybatis.org 上不会提这些——它就是 MyBatis 本身，不负责介绍第三方生态。你得自己去 baomidou.com 看 Plus 的文档。这个边界划得很清楚，官网只做自己该做的事。

用不用 Plus 是另一个话题。我个人的感受是，简单项目用 Plus 确实快，但一旦查询逻辑复杂起来，最后还是得回到 XML 里手写 SQL。MyBatis 本身的灵活性才是它活了这么多年的根本原因。

这个网站不会让你眼前一亮，但它该有的都有。文档结构清晰，示例能跑，中文翻译能用。对于一个开源框架的官网来说，这些就够了。