codebuddy 解析 mybatis xml 不准确时，需确保xml纳入工程上下文、显式声明namespace与resultmap、提供java接口和xml片段作为对话锚点、启用craft智能体校验、使用cli离线验证绑定有效性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 辅助开发 MyBatis 项目时，发现其对 XML 映射文件的解析结果不准确或提示错误，很可能是由于 CodeBuddy 对 MyBatis XML 结构的理解依赖于上下文完整性与显式声明规范。以下是验证与提升理解效果的具体操作路径：
一、确保 XML 文件被正确纳入工程上下文
CodeBuddy 的代码理解能力高度依赖 IDE 已加载的完整项目结构。若 XML 文件未被 Maven/Gradle 正确识别为资源文件，或未与对应 Mapper 接口建立物理或逻辑关联，模型将无法建立 namespace 与接口之间的绑定关系。
1、检查 src/main/resources/mapper/ 目录下 XML 文件是否存在于实际工程路径中，而非仅存于临时目录或未提交的变更区。
2、确认 pom.xml 中 resources 配置包含 mapper 目录，例如：
3、在 IntelliJ IDEA 中右键 XML 文件，选择 “Reload project from Maven”，强制刷新资源索引。
二、显式声明 namespace 与 resultMap 结构
CodeBuddy 在解析时优先匹配显式、无歧义的结构定义。隐式继承、动态 SQL 标签嵌套过深、或使用非标准别名（如 alias="u"）会降低模型对 column-property 映射关系的识别准确率。
1、在
2、为每个
3、在
三、在 CodeBuddy 对话中提供上下文锚点
当直接向 CodeBuddy 提问“这个 resultMap 是否正确？”时，模型缺乏足够判据。必须人工注入关键锚点信息，使其能对齐 Java 实体类字段、数据库实际列名与 XML 声明三者一致性。
1、在提问前，先选中并复制对应 Mapper 接口的完整类定义（含 package、import、public interface 声明）。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、再选中并复制 XML 文件中相关
3、在 CodeBuddy 输入框中粘贴两段代码，并以自然语言描述问题，例如：“UserMapper.java 中有属性 userName 和 createTime，请确认 UserMapper.xml 中 id='userResultMap' 的 column 与 property 是否一一对应。”
四、启用 Craft 智能体执行结构化校验
Craft 是 CodeBuddy 内置的多步推理智能体，可自动执行跨文件比对任务。它能主动读取接口方法签名、提取 XML 中的 id 和 parameterType、扫描 resultMap 的映射项，并生成差异报告。
1、在 CodeBuddy 插件界面点击 “Craft” 按钮，启动智能体工作流。
2、输入指令：“分析 com.example.mapper.UserMapper 接口与其同名 XML 文件，列出所有 id 不匹配、parameterType 类型不一致、resultMap 中 column 不存在于数据库查询结果中的问题。”
3、等待 Craft 返回结构化诊断列表，每条问题均标注具体文件行号与建议修正值。
五、使用 CLI 模式离线验证 XML 语法与绑定有效性
CodeBuddy CLI 提供独立于 IDE 的静态分析能力，可绕过缓存干扰，直接校验 XML 是否符合 MyBatis DTD 规范及基本绑定逻辑，适用于 CI/CD 环境预检。
1、在项目根目录打开终端，执行：codebuddy check --type mybatis --path src/main/resources/mapper/UserMapper.xml。
2、CLI 将输出三类结果：XML 格式错误（如未闭合标签）、namespace 绑定失败（找不到对应接口）、id 冲突（多个标签使用相同 id）。
3、若返回 “Binding OK”，表示该 XML 文件已通过基础绑定验证；若提示 “Unresolved interface”，需检查接口编译产物是否存在于 target/classes 路径下。
