VSCode无法实现MyBatis Mapper接口与XML文件的可靠双向跳转，因缺乏MyBatis语义解析能力；需手动配置DTD约束、SQLTools绑定数据库及严格命名对齐，但仍不支持动态SQL、refid引用和多模块跨路径跳转。
VSCode 无法实现 MyBatis Mapper 接口与 XML 文件之间的可靠双向跳转，这是由底层语言服务缺失 MyBatis 语义解析能力决定的——不是配置不到位，而是架构上不支持。
XML 标签自动补全靠 DTD/XSD，不是靠插件“猜”
MyBatis 的 mapper.xml 文件要获得 <select></select>、<resultmap></resultmap> 等标签提示，必须显式关联约束文件。Red Hat 官方的 XML Language Support 扩展只提供基础 XML 功能，它不会主动下载或识别 MyBatis 的 DTD。
- 手动下载
mybatis-3-mapper.dtd，存入项目schemas/目录（如./schemas/mybatis-3-mapper.dtd） - 在
.vscode/settings.json中添加：{ "xml.fileAssociations": [ { "pattern": "**/*Mapper.xml", "systemId": "./schemas/mybatis-3-mapper.dtd" } ] } - 确保 XML 文件顶部声明匹配 DTD：
—— VS Code 实际不校验 URI 是否可访问，但 <code>PUBLICID 必须与 DTD 文件内SYSTEM声明一致，否则提示失效
SQL 内容智能提示需 SQLTools + 显式绑定
仅靠 XML 补全无法提示表名、字段名。SQLTools 能做到，但必须人工指定哪些文件类型交由它接管，且它不理解 MyBatis 的 #{} 或 ${} 占位符——它只把 <select></select> 标签内的纯 SQL 当作普通 SQL 处理。
- 安装
SQLTools及对应数据库驱动（如 MySQL、PostgreSQL） - 在
settings.json中启用 XML 支持："sqltools.connections": [...], "sqltools.enabledLanguages": ["xml", "plaintext"]
- 关键一步：右键 XML 文件 → “SQLTools: Connect to Connection”，手动为当前文件绑定一个已配置的数据库连接
- 注意：动态 SQL 块（如
<if test="xxx"></if>）内部的 SQL 不会被识别；嵌套<include refid="xxx"></include>的 SQL 也不会被合并分析
跳转功能本质是“单向硬编码匹配”，脆弱且易断
所谓“从接口跳 XML”在 VSCode 中只能靠字符串规则匹配，比如找 com.example.UserMapper.selectById 对应的 UserMapper.xml 里 id="selectById" 的节点。这要求命名严格对齐，且不支持任何中间层抽象（如继承、泛型、@MapperScan 扫描路径变更）。
- 可用插件如
mybatis-tools（Gitee 开源）提供ctrl+m ctrl+d加载映射缓存，但它依赖静态扫描，无法感知编译期生成的代理类或运行时注册的 Mapper -
<include refid="baseColumnList"></include>这类引用不会被识别为跳转目标；<sql id="baseColumnList"></sql>本身也不出现在跳转索引中 - 多模块 Maven 项目中，若 XML 在
resources/mapper/、接口在java/com/example/，VSCode 默认不跨 source root 建立符号链接，跳转直接失败
真正稳定的跳转体验目前只存在于 IntelliJ IDEA 生态。VSCode 用户若坚持使用，需接受“XML 写完后手动打开对应接口查方法签名”这一现实节奏；任何试图用符号链接、自定义 task 或正则脚本模拟跳转的行为，都会在遇到动态 SQL、多级继承或模块拆分时迅速失效。
